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
- Откройте настройки Cursor (
Cmd+Shift+Jна macOS,Ctrl+Shift+Jв остальных системах), перейдите в Models и раскройте API Keys. - Вставьте ключ в OpenAI API Key и включите Use OpenAI API Key.
- Включите Override OpenAI Base URL и укажите
https://api.samreshuuu.ru/v1. - Через Add or search model добавьте
autoи любые другие id со страницы «Модели», точно так, как их называетGET /v1/models. - Выберите модель в списке моделей чата.
Модели вы добавляете сами, поэтому новая модель каталога не появится в 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. |
| Запросы уходят в OpenAI | Override OpenAI Base URL выключен или в адресе нет /v1. |
| HTTP | type | Код | message | Повтор |
|---|---|---|---|---|
| 401 | authentication_error | invalid_api_key | The 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. | нет |
| 404 | not_found_error | model_not_found | The model does not exist. GET /v1/models lists the models this API sells. | нет |
| 400 | invalid_request_error | no_auto_model | No model meets the request for auto. | нет |
| 402 | billing_error | insufficient_balance | The 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. | нет |
| 402 | billing_error | key_limit_exceeded | This 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.