API429 в Cursor: base URL, ключ и проверка доступной модели

Что даёт собственный ключ в редакторе

Подключение удобно, когда вы хотите выбирать доступную через API429 модель и учитывать её использование отдельно от встроенных возможностей Cursor. Начальный сценарий — короткий текстовый вопрос в локальном Chat. Он позволяет проверить адрес, ключ и модель до передачи большого фрагмента проекта или запуска последовательности действий.

Официальная документация Cursor ограничивает собственные OpenAI-ключи стандартными non-reasoning chat-моделями. Поэтому публикация модели в каталоге API429 сама по себе не означает, что она доступна в установленной версии Cursor. В частности, для GPT 6.1 Sol нельзя обещать работу только на основании OpenAI-совместимого endpoint: эта модель имеет reasoning-возможности, а инструменты в справочнике API429 относятся к Responses API.

Подготовьте endpoint и модель для проверки

В качестве OpenAI-совместимого base URL API429 используется https://gateway.api429.com/v1. Для авторизации нужен ваш клиентский ключ API429. GET /v1/models с этим ключом показывает точные доступные ID; он полезнее выбора по красивому названию модели. В командах документации ключ заменён заглушкой YOUR_API429_KEY, которую читатель подставляет локально.

Для условного примера обычного текстового запроса можно проверить gpt-5.6-luna: такая карточка есть в публичном каталоге с объявленной возможностью chat. Это не подтверждает отсутствие reasoning у семейства и не гарантирует, что Cursor примет ID. Если редактор не разрешает добавить или выбрать модель, остановитесь на этой проверке и уточните поддержку в своей сборке.

Заполните настройки Cursor

Откройте Cursor Settings, затем Models и раздел OpenAI API key. Введите свой ключ, сохраните настройку и задайте пользовательский OpenAI base URL. В некоторых версиях поле называется Override OpenAI Base URL; точная подпись элемента зависит от сборки. Текущая документация описывает действие Save, а отдельные версии могут предлагать Verify.

Добавьте или включите соответствующий ID только через доступные возможности интерфейса. Выберите эту модель в локальном Chat и отправьте небольшой несекретный запрос. Не подменяйте неизвестный ID похожим названием и не считайте сохранение ключа доказательством успешного подключения. Результат проверки должен включать ответ именно от выбранной модели без ошибки доступа.

Проверяйте Chat и Agent как разные сценарии

Положительный текстовый ответ проверяет базовый обмен с моделью. Agent дополнительно зависит от ожидаемого формата инструментов, потокового ответа и других параметров клиента. Если вы планируете менять файлы через агента, сначала проверьте небольшой тестовый проект и отдельно оцените предложенные изменения и результат команды проверки. Такой запуск в рамках сверки документации не выполнялся.

Собственный ключ не распространяется на все возможности Cursor. Официальные документы исключают Tab, Auto, Cloud и Background Agents, Automations, Cursor CLI, API и SDK. Нельзя обещать, что API429 заменит встроенные модели в этих режимах. Доступные пользователю возможности редактора и ограничения его плана остаются самостоятельными условиями.

Что делать при ошибке подключения

При 401 проверьте действительность ключа и выбранную настройку провайдера. При 404 сравните base URL с опубликованным адресом и проверьте фактический путь запроса. Ошибка модели требует сверки точного ID, прав ключа и списка моделей Cursor. Если Chat отвечает, а инструмент Agent не работает, не повторяйте большой запрос бесконечно: сначала установите, какой формат или параметр отклонён.

В диагностике используйте код ошибки и обезличенный текст. Не публикуйте ключ и содержимое приватных файлов. Cursor сообщает, что запросы проходят его серверы для окончательной сборки промпта, а ключ передаётся при обращениях по зашифрованному соединению. Подключение собственного API не означает, что вся обработка остаётся на вашем компьютере.

Сколько стоит работа в течение часа

Цена часа зависит от количества обращений, объёма передаваемого кода, длины ответов и повторных действий. Длинная история диалога и большое число попыток меняют расход, поэтому ориентируйтесь на актуальные ставки API429 и фактическое использование. Единую сумму в час для всех проектов обещать нельзя.

Расход модели и условия Cursor учитываются отдельно. Собственный ключ не отменяет стоимость плана редактора. Cursor сообщает, что Zero Data Retention для собственных ключей не применяется; для подходящих запросов Teams и Enterprise может дополнительно действовать Cursor Token Rate. Сверьте условия своей подписки перед постоянной работой. Ключ передаётся по зашифрованному соединению с каждым запросом и, согласно документации Cursor, не сохраняется на его серверах.

Значения полей, конфигурационный справочник, не машинный JSON Cursor

Provider setting: OpenAI
API key: YOUR_API429_KEY
Custom OpenAI base URL: https://gateway.api429.com/v1
Model ID to check (not guaranteed by Cursor): gpt-5.6-luna