Настройка Cursor
Подключите Cursor к GonkaGate через OpenAI-настройки Cursor.
Подключите Cursor к GonkaGate, включив OpenAI API Key, override base URL и один live model ID.
Затем отправьте один короткий чат-запрос до того, как доверять длинной coding-сессии.
Заполните настройки модели в Cursor
Откройте Settings -> Cursor Settings -> Models, затем укажите:
- В блоке
API Keysвключите переключательOpenAI API Key, затем вставьтеgp-your-api-key Override OpenAI Base URL: включеноBase URL:https://api.gonkagate.com/v1Add or search model: добавьте точный GonkaGate model ID из GET /v1/models, напримерqwen/qwen3-235b-a22b-instruct-2507-fp8
После добавления модели убедитесь, что она включена в списке моделей Cursor, прежде чем использовать её в чате.
Перед началом
- Cursor уже установлен.
- У вас уже есть API-ключ GonkaGate в формате
gp-.... - Вам нужен узкий путь настройки именно Cursor, а не более широкий гайд по SDK, миграции или raw API.
- Вы будете использовать текущий live model ID GonkaGate, а не стандартные имена моделей OpenAI по умолчанию.
Проверьте подключение в Cursor
Откройте чат Cursor, выберите добавленную модель и отправьте этот запрос:
Reply with exactly: Cursor connected to GonkaGate
Так вы проверите API key, override base URL и выбор модели до длинной coding-сессии.
Правила именно для Cursor
- Сохраняйте
/v1в base URL. Cursor может сохранить настройку даже при неверном endpoint. - Переключатель
OpenAI API Keyдолжен оставаться включённым. Одного заполненного поля с ключом недостаточно. - Если модель не появляется автоматически, добавляйте точный live GonkaGate model ID вручную.
- Важно не только добавить модель, но и включить её в списке настроек. Сохранённая, но выключенная модель не появится в чате.
- Один короткий чат-запрос после настройки надёжнее, чем доверять только экрану настроек.
Частые первые ошибки
| Если видите | Обычно это значит | Что делать |
|---|---|---|
| Запросы падают сразу или проверка не проходит | Base URL неверный или используется не тот API-ключ GonkaGate | Ещё раз проверьте https://api.gonkagate.com/v1, затем перепроверьте ключ |
| Ключ сохранён, но Cursor ведёт себя так, как будто провайдер не настроен | Переключатель OpenAI API Key в API Keys выключен | Включите переключатель, а не только заполните поле |
| Модель не появляется в чате | Model ID неверный, не включён или picker устарел | Сверьте model ID в GET /v1/models, добавьте его заново при необходимости, включите модель и перезапустите Cursor если нужно |
401 invalid_api_key | Ключ отсутствует, неверный или вставлен не в то поле провайдера | Перепроверьте ключ и страницу Аутентификация и API-ключи |
404 model_not_found | Model ID устарел или неверен | Переключитесь на точный текущий model ID из GET /v1/models |
429 insufficient_quota | На предоплаченном USD-балансе не хватает средств для этого запроса | Проверьте Pricing перед повторной попыткой |
429 rate_limit_exceeded | Запрос уперся в throttling | Повторяйте запрос с bounded backoff и используйте Обработка rate limits для полной политики |
См. также
- Гайды по фреймворкам и инструментам для другого пути через фреймворк или инструмент
- Аутентификация и API-ключи для хранения ключей, ротации и проблем с auth
- Выбор моделей для выбора модели до фиксации её в Cursor
- GET /v1/models — Получить список моделей чтобы проверить точный live model ID для Cursor
Была ли эта страница полезной?