> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gpuhub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Configure Cursor to call AI Gateway models with a custom OpenAI-compatible model provider.

<img src="https://mintcdn.com/gpuhub/GEB8Gf9uDczdNFr-/images/ide-agents-cursor-icon.png?fit=max&auto=format&n=GEB8Gf9uDczdNFr-&q=85&s=3111fea4865386415a5f5a4f9ae37483" alt="" width="96" height="96" data-path="images/ide-agents-cursor-icon.png" />

Cursor can call AI Gateway models through a custom OpenAI-compatible provider. Cursor Free may only support Auto mode; use Cursor Pro or a higher plan if custom model providers are required.

<Warning>
  Cursor may fuzzy-match custom model names against built-in model names. If a custom model name overlaps with a built-in model name, Cursor may route the request to its own provider instead of AI Gateway.
</Warning>

## Configure a Custom Model

Use the following values when adding a custom provider or model in Cursor.

| Field      | Value                                 |
| ---------- | ------------------------------------- |
| API Key    | Your AI Gateway API key               |
| Base URL   | `https://llm.gpuhub.com/api/v1`       |
| Model name | A custom alias such as `gpuhub-model` |

<img src="https://mintcdn.com/gpuhub/okogEM35aUTWSg4p/images/ide-agents-cursor-provider-settings.png?fit=max&auto=format&n=okogEM35aUTWSg4p&q=85&s=d5a4ac301ea910cd0d6ea8b44e0a55c3" alt="" width="1365" height="932" data-path="images/ide-agents-cursor-provider-settings.png" />

## Avoid Built-In Model Name Matching

If you want to use a model such as `gpt-5.4`, avoid naming the Cursor custom model `gpt-5.4` directly. Use an unrelated alias such as `gpuhub-model`, then map that alias to the target model in the AI Gateway model settings.

<img src="https://mintcdn.com/gpuhub/okogEM35aUTWSg4p/images/ide-agents-cursor-model-mapping.png?fit=max&auto=format&n=okogEM35aUTWSg4p&q=85&s=bc1a1a826b74968b750a06bd5b8718c1" alt="" width="1414" height="712" data-path="images/ide-agents-cursor-model-mapping.png" />

## Recommended Flow

1. Create a custom model alias in Cursor, such as `gpuhub-model`.
2. Set the Base URL to `https://llm.gpuhub.com/api/v1`.
3. Enter your API key.
4. Map `gpuhub-model` to the target AI Gateway model in the console.
5. Select `gpuhub-model` in Cursor when starting a chat or coding task.
