Skip to main content
Чтобы подключить Cursor custom API, укажите OpenAI Base URL https://bettertoken.ai/v1, API Key BetterToken и точный Model ID. Если проверка ключа завершается ошибкой, проверьте адрес и повторно добавьте custom model.

​
Cursor custom API и API Key error

Пошаговая настройка полей собрана в FAQ по Cursor custom OpenAI API. Для сравнения интерфейсов откройте Cline и Zed, а правила выбора адреса — в руководстве по Base URL.

​
Ключевые параметры

​
Подготовка

​
Дополнительные требования

  • Установленный Cursor (скачать Cursor)
  • Вы будете использовать provider GPT и модель, совместимую с настроенным endpoint

​
Установка

Скачайте и установите актуальную версию с сайта Cursor. Войдите в аккаунт Cursor, который поддерживает custom models, затем перейдите к настройке ниже.
Cursor позволяет настраивать custom models только пользователям платного advanced tier или выше. Если в вашем аккаунте или версии клиента нет опций custom model, API Key или Base URL, сначала проверьте план Cursor и версию клиента.
Известное ограничение: Override OpenAI Base URL — глобальная настройка. Когда она включена, она влияет на все API keys, настроенные в Cursor, включая Anthropic / GPT keys для встроенных моделей Cursor. Официальное сообщество Cursor подтверждало это поведение: Base URL влияет на все API keys и модели (обсуждение).Если встроенные Claude / GPT модели Cursor перестали работать после включения Override OpenAI Base URL, выключайте Override OpenAI Base URL, когда не используете BetterToken. Cursor пока не поддерживает отдельный Base URL для каждой модели; эта возможность отслеживается как feature request (feature request).

​
Ручная настройка

Выполните эту настройку в интерфейсе Cursor. Редактировать конфигурационный файл вручную не требуется.

​
Настройка

1

Откройте страницу настроек моделей

В Cursor нажмите Settings в левом нижнем углу, затем перейдите в Models и прокрутите до API Keys.
2

Введите Base URL и API Key

В API Keys заполните поля в таком порядке:
  1. Включите Override OpenAI Base URL
  2. Введите https://bettertoken.ai/v1 в поле Base URL
  3. Вставьте API Key BetterToken в OpenAI API Key
  4. После заполнения URL и ключа включите toggle OpenAI API Key
Введите ключ до включения toggle. Так Cursor покажет dialog подтверждения авторизации.
3

Включите OpenAI API Key

В dialog подтверждения нажмите Enable OpenAI API Key.
4

Обновите список моделей и включите модели

В Models нажмите кнопку refresh справа перед выбором модели. Дождитесь завершения обновления списка.Выбирайте модели provider GPT, совместимые с OpenAI-compatible endpoint. Скопируйте Model ID из model plaza, затем включите toggle для этой модели.
5

Вернитесь в chat и выключите Auto

После настройки вернитесь в chat Cursor и откройте model picker под полем ввода. Если включен Auto, сначала выключите Auto.
6

Выберите модель и начните чат

Выберите включенную модель поддерживаемого провайдера и начните общение.

​
Проверка подключения

Отправьте короткий тестовый запрос. Если инструмент возвращает ответ без ошибок авторизации или Model ID, подключение работает. После изменения конфигурации полностью перезапустите инструмент.

​
Смена модели

Откройте селектор моделей или измените поле Model в конфигурации. Используйте точный Model ID из каталога моделей, затем перезапустите текущую сессию.

​
Частые ошибки

​
Ошибки custom API и API Key

Перед сменой модели или API Key сравните текущие параметры с настройкой Cursor custom OpenAI API.

​
В Cursor нет полей Custom API, API Key или Base URL

Проверьте план и версию приложения Cursor. Custom models доступны только в поддерживаемых платных tiers. После обновления Cursor снова откройте Settings → Models.

​
API Key не включается или не проходит проверку

Проверьте, что вы сначала ввели Base URL https://bettertoken.ai/v1 и API Key, а уже затем включили toggle OpenAI API Key. Не добавляйте /chat/completions к Base URL и не используйте Model ID, несовместимый с endpoint.

​
После refresh нет нужной модели

Убедитесь, что выбранный Model ID доступен у провайдера GPT, дождитесь окончания refresh и включите только модель, совместимую с настроенным endpoint. Текущий список ID всегда доступен в model plaza.

​
Встроенные модели Cursor перестали работать

Override OpenAI Base URL действует глобально. Когда вы не используете BetterToken, выключайте этот toggle, чтобы Cursor вернулся к собственному Base URL.

​
В чате выбирается не та модель

Откройте model picker и выключите Auto. Затем выберите включенную модель вручную.

​
Связанные FAQ

​
Расширенная настройка

​
Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Ручная настройка: укажите API Key, Base URL и Model.
  • Не поддерживается: проверенный способ прямого подключения пока отсутствует.

​
Технические детали

В описанном сценарии используется Base URL https://bettertoken.ai/v1. Инструмент сам добавляет путь OpenAI-compatible endpoint. Не добавляйте /chat/completions или /responses к Base URL, если это не требуется конкретным полем.

​
Примечания

  • Не используйте ID моделей провайдера Claude в Codex / OpenAI-compatible flow
  • Не используйте жестко заданные имена Claude-моделей; берите актуальный Model ID поддерживаемого провайдера из model plaza