Cursor integration
Use Gonka24 with Cursor
Connect Cursor to Gonka24 with an OpenAI-compatible base URL, a Gonka24 API key, and a live model ID.
Configuration verified August 31, 2026
Connection details
Every example on this page uses the same Gonka24 OpenAI-compatible endpoint, a dashboard API key, and a live model ID.
- Base URL
- https://api.gonka24.com/v1
- Authentication
- Bearer sk-...
- Model
- GET /v1/models
Use a live model ID.
The catalog changes. Call GET /v1/models with your API key and copy an id from the response instead of relying on a model name in a guide.
bash
curl https://api.gonka24.com/v1/models \
-H "Authorization: Bearer $GONKA24_API_KEY"Ready-to-use config
Cursor Settings → Models → OpenAI API key
Paste these values into Cursor's model settings. The base URL must end in /v1, not /v1/chat/completions.
text
OpenAI API key: sk-...
Override OpenAI Base URL: https://api.gonka24.com/v1
Model: <model-id-from-/v1/models>Set up Cursor
- Open Cursor Settings, select Models, and find the OpenAI API key section.
- Paste your Gonka24 key, enable the custom base URL override, and enter https://api.gonka24.com/v1.
- Add or enable an exact model ID returned by GET /v1/models, then verify the key.
- Select that model in a local Chat or Agent session and send a short prompt.
What is supported
Supported
Local Chat and Agent
OpenAI-compatible requests can use the custom key and base URL when Cursor accepts the selected model.
Supported
Chat Completions
Gonka24 supports non-streaming and streaming OpenAI-compatible chat completions.
Not included
Cursor-managed features
Cursor Tab, Auto, Cloud or Background Agents, Automations, the Cursor CLI, and Cursor SDK/API do not use BYOK gateway credentials.
Not included
Specialized model behavior
Cursor documents custom OpenAI keys for standard chat models. Do not assume every reasoning control or model-specific feature is forwarded.
Verify before an agent task
- Fetch the model list and copy an exact model ID.
- Send a short plain chat request through Cursor.
- Confirm the request appears in your Gonka24 dashboard activity.
- Only then enable tool use, file writes, or long-running agent work.
Troubleshooting
Verify fails: Confirm the override is exactly https://api.gonka24.com/v1 and that the API key is active.
Model is missing: Refresh GET /v1/models, copy the ID exactly, and add it to Cursor's model list.
Native Cursor models stop working: Disable the OpenAI base URL override when switching back to Cursor-managed models; the override is global to the OpenAI provider settings.
Tab or cloud agent ignores Gonka24: This is expected: those Cursor-managed features do not use the custom OpenAI key.
Verification sources
Checked against the product documentation below and the Gonka24 public API contract on August 31, 2026.
