Как подключить KupiAPI в Cursor

Cursor поддерживает свой OpenAI-совместимый endpoint только на платных тарифах. На Free / Hobby план Override Base URL и BYOK отключены — нужен Cursor Pro (или выше). После апгрейда: Settings → Models → включите свой API-ключ и укажите Base URL KupiAPI.

Инструменты~5 мин · 6 шагов

Что понадобится

  • Cursor Pro (или выше) — без подписки Override Base URL заблокирован
  • Аккаунт в личном кабинете KupiAPI (вход по телефону +7 и паролю)
  • Пополненный баланс от 200 ₽ или пробный ключ во вкладке «Ключи»
  • API-ключ из кабинета (начинается с rk_live_…)

Видеоинструкция

Подключение KupiAPI в Cursor за 2 минуты

Settings → Models → API Keys: ключ rk_live_… и Base URL https://kupiapi.ru/v1. В чате выберите модель из списка (gpt-5.4-mini, claude-sonnet и др.).

Пошагово

  1. 01

    Откройте Settings → Models

    В Cursor нажмите на иконку шестерёнки или используйте Ctrl+, (Cmd+, на Mac). В левом меню выберите раздел Models — именно там настраивается свой OpenAI-ключ и Base URL.

    Cursor · Settings
    Настройки Cursor: в боковом меню выделен пункт Models
    Settings → Models в левой колонке.
  2. 02

    Раскройте блок API Keys

    Прокрутите страницу Models вниз до секции API Keys и нажмите на неё, чтобы развернуть поля для ключа и Base URL.

    Cursor · Models
    Страница Models в Cursor, внизу секция API Keys
    Внизу списка моделей — секция API Keys.
  3. 03

    Включите ключ и Base URL KupiAPI

    Включите переключатель OpenAI API Key и вставьте ключ rk_live_… из личного кабинета KupiAPI. Затем включите Override OpenAI Base URL и укажите адрес KupiAPI.

    Cursor · API Keys
    В Cursor включены OpenAI API Key и Override OpenAI Base URL с адресом kupiapi.ru/v1
    Ключ из кабинета + Base URL https://kupiapi.ru/v1.
    Код
    https://kupiapi.ru/v1

    Адрес — https://kupiapi.ru/v1 без завершающего слэша. Оба переключателя должны быть включены (зелёные).

  4. 04

    Добавьте модель kupi-* в Cursor

    Settings → Models → Add custom model. Для Agent с BYOK используйте id без подстроки gpt-5.5 — например kupi-gpt55-high, kupi-gpt55-medium, kupi-gpt55-low, kupi-gpt54-mini, kupi-gpt54, kupi-claude-sonnet, kupi-deepseek-chat. Cursor ломает BYOK на именах gpt-5.5-high; kupi-gpt55-high — тот же GPT-5.5 на нашей стороне. Полный список алиасов — GET https://kupiapi.ru/v1/models.

    Composer, Auto и thinking-модели Cursor не работают с кастомным ключом — только по подписке Cursor.

  5. 05

    Выберите модель в Agent

    В Agent (Ctrl+I) выберите добавленную модель kupi-gpt55-high (или kupi-gpt54-mini для быстрых задач). Effort high/medium/low задаётся суффиксом в id.

  6. 06

    Проверьте запрос

    Отправьте короткий запрос в Agent или Chat. Если ответ пришёл — подключение успешно. Расход токенов отображается в истории баланса в /cabinet.

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

Нужна ли подписка Cursor Pro?
Да. На Free / Hobby плане Cursor не даёт переопределить Base URL и подключить свой OpenAI-ключ — поля просто заблокированы. Минимум Cursor Pro ($20/мес). Это ограничение Cursor, не KupiAPI: мы — провайдер моделей, но Cursor пускает свой ключ только подписчикам Pro и выше.
Почему модели в Cursor называются kupi-gpt55-high, а в API — gpt-5.5?
Cursor BYOK ломается на именах с подстрокой gpt-5.5 (routing_unsupported). Мы завели алиасы kupi-* специально для Cursor — добавьте custom model kupi-gpt55-high. Внутри это тот же GPT-5.5: запрос с model: "kupi-gpt55-high" мы конвертируем в gpt-5.5 + reasoning effort high. В чистом OpenAI SDK / curl используйте оригинальные имена: gpt-5.5, claude-sonnet, deepseek-chat.
Ошибка «This model does not support custom API keys» в Agent
Cursor не пускает Composer / Auto / thinking-модели с BYOK. Добавьте custom model kupi-gpt55-high (или kupi-gpt54-mini), Base URL https://kupiapi.ru/v1, ключ rk_live_…, баланс > 0.
Ошибка routing_unsupported / GPT-5.5 routing only supports Responses-compatible requests
Баг Cursor BYOK: имена с gpt-5.5 в Agent ломают маршрутизацию. Не используйте gpt-5.5-high — добавьте custom model kupi-gpt55-high (или kupi-gpt55-medium / kupi-gpt55-low). Base URL https://kupiapi.ru/v1 без изменений.
Agent mode в Cursor не работает / «messages must be a non-empty array»
KupiAPI поддерживает Cursor Agent: конвертируем Responses API (input), проксируем tools. Base URL https://kupiapi.ru/v1, модель kupi-gpt55-high или kupi-gpt54-mini, баланс > 0.
Cursor пишет «Invalid API Key»
Проверьте, что ключ скопирован целиком, Base URL — https://kupiapi.ru/v1, баланс больше нуля.
Какая модель лучше для кода?
Для сложных задач — kupi-gpt55-high или kupi-claude-sonnet. Для быстрых правок — kupi-gpt54-mini или kupi-deepseek-chat.

Готово к работе

Пополните баланс в кабинете и проверьте расход в истории.

Base URL

Endpoint
https://kupiapi.ru/v1

Смотрите также