К содержимому
Блог

Как подключить Cursor к custom API Relay

Как подключить Cursor к custom API Relay

Cursor подключается к Relay по OpenAI-совместимому протоколу. В настройках нужен адрес https://relay-llm.ru/v1, API-ключ и идентификатор модели из каталога. Начинайте с чата в Ask или Plan, а не с автономной задачи агента.

Коротко

  • В поле Base URL укажите https://relay-llm.ru/v1.

  • Добавьте модель по её точному идентификатору из каталога.

  • Собственные модели работают в чате, а Agent mode через чужой адрес отмечен как частично проверенный.

Настройка Custom API в Cursor

Откройте Settings, затем Models. Введите ключ Relay в поле OpenAI API Key. Включите Override OpenAI Base URL и укажите https://relay-llm.ru/v1. После этого добавьте модель вручную по идентификатору из каталога.

Адрес должен быть доступен из интернета. Cursor отправляет запросы с собственных серверов, поэтому localhost, домашний IP и адрес внутри VPN не подойдут. Relay уже доступен по публичному адресу, дополнительный туннель не нужен.

Первый запрос из Cursor

  1. Создайте отдельный ключ

    В кабинете Relay создайте ключ для Cursor. Не используйте ключ из чужого проекта или общего чата.

  2. Укажите Base URL

    В Cursor включите Override OpenAI Base URL и введите https://relay-llm.ru/v1.

  3. Добавьте модель

    Скопируйте идентификатор из каталога и добавьте его в список моделей Cursor без сокращений.

  4. Проверьте чат

    Откройте Ask или Plan, выберите добавленную модель и отправьте «ping». Затем найдите запрос в журнале.

Что работает, а что лучше не обещать

Чат с собственной моделью проходит по OpenAI Chat Completions. Tab остаётся на встроенных моделях Cursor и не использует Relay. В Agent mode с чужим Base URL у Cursor встречаются ошибки выбора модели и подмена модели для субагента, поэтому его нельзя считать проверенным сценарием для рабочей автоматизации.

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

Не включайте одновременно свой ключ Anthropic и custom OpenAI API для одной связки. Запрос Claude может уйти через OpenAI-формат и получить 422. Выберите один способ подключения для конкретной проверки.

Имена моделей и автодополнение

В поле списка моделей Cursor вводят то, что потом уйдёт в запросе как model. Relay сверяет идентификатор из каталога точно, по регистру: claude-sonnet-5 принят, Claude-Sonnet-5 нет. У многих моделей в ответе GET /v1/models есть поле aliases с короткой записью вида anthropic/claude-sonnet-5. Такие алиасы шлюз принимает без учёта регистра, но надёжнее копировать public_id со страницы модели: он не зависит от вендорского префикса.

Автодополнение через ключ Relay не настраивается. Официальная страница Cursor о собственных ключах говорит, что они работают только с чат-моделями, а Tab остаётся на встроенных. Поэтому смена модели в настройках Tab ничего не меняет, и таких запросов в журнале Relay не будет. Если Tab тормозит или отвечает неожиданно, дело не в шлюзе.

Сколько это стоит на практике

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

Практичный способ прикинуть расход: откройте десять последних запросов Cursor, посчитайте среднюю цену и умножьте на число запросов в день. Чтобы прикидка не превратилась в сюрприз, задайте на ключе Cursor лимит на день или месяц: запрос сверх лимита получит key_limit_exceeded, и средства не спишутся.

Если Cursor отвечает ошибкой

Сначала убедитесь, что URL заканчивается на /v1, а модель есть в списке моделей API. Затем проверьте запрос в кабинете. Если записи нет, Cursor не дошёл до Relay, и нужно перепроверить настройки клиента. Если запись есть, код и текст ошибки помогут разобрать ситуацию по руководству об ошибках.

Подробный разбор типовых сбоев есть в статье о диагностике Cursor. Инструкции для Relay и перечень ограничений обновляются на странице Cursor. Там же указан статус частичной проверки Agent mode.

Нужен ли /v1 в Override OpenAI Base URL?

Да. Для Cursor укажите https://relay-llm.ru/v1. Это OpenAI-совместимый адрес.

Почему модель не появилась в списке Cursor?

Добавьте её идентификатор вручную в настройках Models. Сверьте написание с каталогом.

Работает ли Tab через Relay?

Нет. Tab использует модели самого Cursor. Relay можно применять для чата с добавленной моделью.

Источники

Что Cursor делает с собственными ключами и Tab, сверено с разделом API keys документации Cursor на 14 октября 2026. Правила сопоставления имён моделей взяты из кода каталога Relay.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.