Документация API go2llm

Cursor со своим API: Override OpenAI Base URL и ключ go2llm

Если вы ищете «Cursor заблокировали» или «Cursor не работает в России», начните с проверенного пути замены через Claude Code или OpenCode. Связку Cursor с go2llm живым запросом не проверяли. В настройках Cursor есть переключатель Override OpenAI Base URL, поле для ключа и список Custom Models; ниже — шаги для самостоятельной проверки с адресом https://go2llm.tech/v1 и ключом gk_sk_….

Проверку живым запросом мы ещё не делали. Для неё нужен запущенный GUI Cursor, и мы не утверждаем ни что связка работает, ни что не работает. Инструкция ниже составлена по документации и по настройкам самого Cursor; шаг «проверка» в ней не формальность, а единственный способ узнать результат. Живым запросом у go2llm проверены Claude Code и OpenCode. Если вы прошли шаги ниже — напишите в @go2llm_support, что получилось: мы поставим на этой странице фактический статус вместо пометки.

Источники: Cursor — Models, LiteLLM — Cursor integration.

Дата публикации: 14 сентября 2026.

Что понадобится

  1. Установленный Cursor с доступом к разделу настроек моделей.
  2. Ключ go2llm с префиксом gk_sk_. При регистрации на баланс начисляется $1 — этого хватает на проверку без пополнения. Минимальное пополнение — $1.
  3. Base URL для OpenAI-совместимого протокола: https://go2llm.tech/v1.
  4. Точный public ID модели. Каталог отдаёт открытый эндпоинт без ключа: curl https://go2llm.tech/v1/models. Нужна модель, у которой в поле endpoints есть chat.completions.

Пошаговая настройка

Шаг 1. Включите Override OpenAI Base URL

Откройте Settings → Cursor Settings → Models, найдите переключатель Override OpenAI Base URL и включите его. В поле адреса укажите:

https://go2llm.tech/v1

Суффикс /v1 обязателен: Cursor дописывает к базе /chat/completions, и без /v1 запрос уйдёт на несуществующий путь.

В каких сборках и на каких тарифах Cursor показывает переключатель Override OpenAI Base URL, мы не знаем: по сообщениям пользователей он виден не во всех версиях, но своей проверкой мы это не подтверждали.

Шаг 2. Положите ключ в поле OpenAI API Key

В том же разделе есть поле ключа OpenAI. Вставьте туда ключ go2llm целиком, вместе с префиксом:

gk_sk_ВАШ_КЛЮЧ

Ключ, base URL и model ID обязаны относиться к одному провайдеру: ключ go2llm с адресом OpenAI (или наоборот) даст ошибку авторизации, а не смешанный режим.

Шаг 3. Добавьте модель в Custom Models

В списке моделей добавьте собственную модель и укажите точный id из каталога — не «gpt-4o» и не отображаемое имя. Скопировать значение:

curl -s https://go2llm.tech/v1/models

Берите модель, у которой в endpoints есть chat.completions: Cursor говорит именно этим протоколом. Проверить одну модель точечно теперь можно отдельным запросом:

curl -s https://go2llm.tech/v1/models/claude-sonnet-5

В ответе id будет каноническим (claude-sonnet-4-5), даже если вы спросили по алиасу — в Custom Models удобнее указывать то, что вернул каталог.

Шаг 4. Нажмите Verify, а потом проверьте два режима отдельно

Кнопка Verify проверяет, что по указанным адресу и ключу вообще отвечает совместимый endpoint. Зелёная галочка на ней — это ещё не рабочая интеграция.

Дальше нужны две отдельные проверки:

  1. Реальный запрос в чате.
  2. Реальный запрос в агентном режиме.

Это разные пути внутри Cursor, и результат у них может отличаться: часть функций Cursor завязана на модели и бэкенд самого Cursor независимо от вашего override — так, tab-автодополнение через свой base URL не идёт. Поэтому «в чате ответило» не означает «агент работает», и наоборот.

Шаг 5. Сверьте списание

После успешного ответа откройте кабинет go2llm и сверьте списание с полем usage.cost_usd, которое шлюз возвращает в каждом ответе. Расхождение — повод написать в поддержку с request_id из тела ошибки или из заголовка x-go2llm-request-id.

Проверка, что заработало

Сначала проверьте сам шлюз — так вы отделите проблему Cursor от проблемы ключа:

curl https://go2llm.tech/v1/chat/completions \
  -H "Authorization: Bearer gk_sk_ВАШ_КЛЮЧ" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":120,"messages":[{"role":"user","content":"Ответь одним словом: работает"}]}'

Ожидаемый результат: HTTP 200, в choices[0].message.content — «работает», в блоке usage — поле cost_usd с фактической стоимостью запроса в долларах.

Баланс перед длинной сессией можно прочитать ключом:

curl https://go2llm.tech/v1/me -H "Authorization: Bearer gk_sk_ВАШ_КЛЮЧ"

В ответе — balance.spendable_usd, key.quota_usd, key.rpm_limit. Если шлюз отвечает на оба запроса, а Cursor — нет, дело в настройках Cursor, а не в ключе.

Какую модель выбрать

Актуальные ставки по каждой модели — на странице цен и в GET /api/pricing.

МодельЗачем в Cursor
claude-sonnet-5Основная рабочая модель для чата и правок
claude-opus-5Разбор незнакомой кодовой базы, сложный рефакторинг
claude-haiku-4-5Быстрые правки, коммит-сообщения
gpt-5.3-codexГенерация кода на OpenAI-стеке
gpt-5.6-lunaЧерновики, где цена важнее качества
deepseek-v4-proМассовые операции на большом контексте

Полный прайс — go2llm.tech/pricing.

Если не работает

  • 401 no-key. Ключ не дошёл или обрезан. Проверьте префикс gk_sk_ и что ключ вставлен в поле OpenAI API Key, а не в соседнее.
  • 404 model_not_found. В Custom Models указан ID, которого нет в каталоге. Скопируйте точное значение из curl https://go2llm.tech/v1/models.
  • 404 endpoint_not_found. Клиент постучался в маршрут, которого у шлюза нет. В теле ошибки перечислены все опубликованные маршруты — сверьте с тем, что показывает Cursor.
  • 400 model_protocol_mismatch. Модель не обслуживается на chat.completions. Возьмите из /v1/models ту, у которой этот endpoint указан.
  • 402 insufficient_balance. Пополните баланс (минимум $1). Шлюз резервирует оценочную стоимость до вызова, и баланс не уходит ниже нуля.
  • 429 rate_limit. На ключ действует лимит 20 RPM по умолчанию, считается суммарно по всем моделям и endpoint'ам. Учитывайте заголовок Retry-After; отдельный лимит параллельных запросов на аккаунт — 2 по умолчанию.
  • 400 unsupported_content_type. В запрос попало изображение или PDF: текстовые endpoint'ы go2llm бинарные вложения не принимают.

Разбор кодов целиком — go2llm.tech/docs/errors.

FAQ

Работает ли агентный режим Cursor через go2llm? Про агентный режим мы не знаем и не утверждаем ничего. Проверять его нужно отдельно от чата: это разные пути, и чат может отвечать при неработающем агенте.

Работает ли tab-автодополнение? Нет: оно идёт на модели самого Cursor и переключателем base URL не переводится.

Можно ли подключить Cursor по Anthropic-протоколу? У go2llm есть нативный /v1/messages без прослойки-конвертера, но переключатель в Cursor называется именно «Override OpenAI Base URL» и предполагает протокол OpenAI Chat Completions. Связку Cursor + Anthropic-протокол мы не проверяли и не утверждаем ни что она работает, ни что нет.

Настроите за меня? Нет — интеграции за клиента мы не настраиваем. Отвечаем на вопросы по шлюзу: support@go2llm.tech, @go2llm_support.

Что дальше

Другие редакторы и агенты — в хабе инструментов и на странице инструментов для кода. Эндпоинты, лимиты и форматы ответа — go2llm.tech/docs.

Получить ключ и сделать первый запрос за 3 минуты →