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

  1. Open Cursor Settings, select Models, and find the OpenAI API key section.
  2. Paste your Gonka24 key, enable the custom base URL override, and enter https://api.gonka24.com/v1.
  3. Add or enable an exact model ID returned by GET /v1/models, then verify the key.
  4. 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

  1. Fetch the model list and copy an exact model ID.
  2. Send a short plain chat request through Cursor.
  3. Confirm the request appears in your Gonka24 dashboard activity.
  4. 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.