# 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. Создайте ключ

В [консоли разработчика](https://console.samreshuuu.ru) откройте «Ключи 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 со страницы [«Модели»](/models), точно так, как их называет `GET /v1/models`.
5. Выберите модель в списке моделей чата.

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

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

Отправьте запрос в чат на `auto`. Вызов появится в журнале вызовов [консоли](https://console.samreshuuu.ru) с моделью, которую выбрал `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` ответа.
