Cursor

Cursor умеет слать запросы чата в совместимый с OpenAI адрес, если дать ему свой ключ API и базовый адрес. API моделей отвечает на них по POST /v1/chat/completions. Эти настройки Cursor держит в своём окне, а не в файле, поэтому настройка занимает несколько щелчков. Модель auto сама выбирает модель каталога для разговора.

Что покрывает замена адреса

Настройка Override OpenAI Base URL в Cursor действует на все запросы в формате OpenAI и говорит только на Chat Completions.

Модель в CursorИдёт через API моделей?
Имена моделей, которые вы добавили сами, в том числе autoДа
Собственные модели OpenAI в CursorДа, пока замена включена
Собственные модели Cursor: Claude, Gemini, Grok и ComposerНет, остаются на серверах Cursor
Автодополнение Tab, Apply и правка в строкеНет, остаются на серверах Cursor

Запрос со своим базовым адресом Cursor отправляет со своих серверов: ключ API моделей и промпты проходят через сервера Cursor, как с любым своим ключом в Cursor.

1. Создайте ключ

В консоли разработчика откройте «Ключи API», оставьте в поле Доступ вариант Ключ API моделей и создайте ключ. Скопируйте его: секрет показывается один раз.

2. Настройте Cursor

  1. Откройте настройки Cursor (Cmd+Shift+J на macOS, Ctrl+Shift+J в остальных системах), перейдите в Models и раскройте API Keys.
  2. Вставьте ключ в OpenAI API Key и включите Use OpenAI API Key.
  3. Включите Override OpenAI Base URL и укажите https://api.samreshuuu.ru/v1.
  4. Через Add or search model добавьте auto и любые другие id со страницы «Модели», точно так, как их называет GET /v1/models.
  5. Выберите модель в списке моделей чата.

Модели вы добавляете сами, поэтому новая модель каталога не появится в Cursor, пока вы не добавите её так же.

3. Проверьте подключение

Отправьте запрос в чат на auto. Вызов появится в журнале вызовов консоли с моделью, которую выбрал auto, и его стоимостью. Инструменты режима агента идут функциями OpenAI; уровень рассуждений, который шлёт Cursor, уходит дальше как reasoning_effort.

Как отменить настройку

На той же странице настроек выключите Use OpenAI API Key и Override OpenAI Base URL или верните прежние ключ и адрес, а добавленные модели уберите.

Если что-то не так

Что видноЧто проверить
«Invalid API key»Ключ вставлен с ошибкой или отозван. Проверьте его в «Ключах API» консоли.
Cursor не находит ресурсCursor получил 404 от адреса. Адрес кончается на /v1, и после него ничего нет.
Cursor пишет, что модели нетid написан с ошибкой или его нет в каталоге: скопируйте его из GET /v1/models.
Запрос на auto не появляется в журнале вызововCursor принял имя за свою модель: проверьте, что замена адреса включена, затем уберите и снова добавьте auto.
Запросы уходят в OpenAIOverride OpenAI Base URL выключен или в адресе нет /v1.
HTTPtypeКодmessageПовтор
401authentication_errorinvalid_api_keyThe API key is unknown, disabled, revoked or expired. Switch a disabled key back on in the developer console; create a new one in place of a revoked or expired key.нет
404not_found_errormodel_not_foundThe model does not exist. GET /v1/models lists the models this API sells.нет
400invalid_request_errorno_auto_modelNo model meets the request for auto.нет
402billing_errorinsufficient_balanceThe organization balance does not cover this request (max_tokens is held in full until the answer is settled). Top up the balance or lower max_tokens.нет
402billing_errorkey_limit_exceededThis API key has reached its spending limit. Raise the limit or use another key.нет

Если ошибка не проходит, напишите в поддержку и приложите x-request-id ответа.

Частые вопросы

Идёт ли автодополнение Tab через API моделей?

Нет. Tab, Apply и правка в строке остаются на серверах Cursor, как и собственные модели Cursor: Claude, Gemini, Grok и Composer. За заменой адреса идут только запросы чата в формате OpenAI.

Доходят ли мои запросы до API моделей напрямую?

Нет. Запрос со своим базовым адресом Cursor отправляет со своих серверов, поэтому ключ и промпты проходят через сервера Cursor, как с любым своим ключом в Cursor.

Была ли страница полезна?