Cursor Setup
Connect Cursor to GonkaGate through Cursorβs OpenAI settings.
Connect Cursor to GonkaGate by enabling Cursorβs OpenAI key path, overriding the base URL, and adding one live model ID. Then run one short chat request before you trust a longer coding session.
Set the model settings in Cursor
Open Settings -> Cursor Settings -> Models, then configure:
- In
API Keys, enable theOpenAI API Keytoggle, then pastegp-your-api-key Override OpenAI Base URL: enabledBase URL:https://api.gonkagate.com/v1Add or search model: add an exact GonkaGate model ID from GET /v1/models, for exampleqwen/qwen3-235b-a22b-instruct-2507-fp8
After you add the model, make sure it is enabled in Cursorβs models list before you try to use it in chat.
Before you start
- Cursor is already installed.
- You already have a GonkaGate API key in
gp-...format. - You need the narrow Cursor setup path, not a broader SDK, migration, or raw API walkthrough.
- You will choose a current live model ID from GonkaGate instead of assuming OpenAI default model names.
Verify the connection in Cursor
Open the Cursor chat panel, select the model you added, and send this prompt:
Reply with exactly: Cursor connected to GonkaGate
That confirms the API key, base URL override, and model selection before a longer coding session.
Cursor-specific rules
- Keep
/v1in the base URL. Cursor can save the setting even when the endpoint is wrong. - The
OpenAI API Keyswitch must stay enabled. A filled input field alone is not enough. - Add the exact live GonkaGate model ID manually if it does not appear automatically in the search box.
- Enabling a model in the settings list matters as much as adding it. A saved model that stays disabled will not be available in chat.
- One short chat prompt after setup is a safer canary than trusting the settings screen alone.
Common first failures
| If you see | What it usually means | What to do |
|---|---|---|
| Requests fail immediately or verification does not work | The base URL is wrong or the API key is not the GonkaGate key you intended to use | Recheck https://api.gonkagate.com/v1, then confirm the API key |
| The key looks saved but Cursor still behaves as if no provider is configured | The OpenAI API Key toggle is off in API Keys | Turn the toggle on, not just the input field |
| The model does not appear in chat | The model ID is wrong, not enabled, or the picker is stale | Verify the model ID in GET /v1/models, add it again if needed, ensure it is enabled, then restart Cursor if necessary |
401 invalid_api_key | The key is missing, invalid, or pasted into the wrong provider field | Recheck the key and Authentication and API Keys |
404 model_not_found | The model ID is stale or invalid | Switch to an exact current model ID from GET /v1/models |
429 insufficient_quota | The prepaid USD balance is too low for this request | Check Pricing before retrying |
429 rate_limit_exceeded | The request was throttled | Retry with bounded backoff and use Rate Limit Handling for the full policy |
See also
- Framework and Tool Guides for a different framework or coding-tool path
- Authentication and API Keys for key storage, rotation, and auth troubleshooting
- Model Selection Guide for choosing a model before you keep it in Cursor
- GET /v1/models to confirm the exact live model ID that Cursor should use
Was this page helpful?
