Как подключить 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
- Создайте отдельный ключ
В кабинете Relay создайте ключ для Cursor. Не используйте ключ из чужого проекта или общего чата.
- Укажите Base URL
В Cursor включите Override OpenAI Base URL и введите
https://relay-llm.ru/v1. - Добавьте модель
Скопируйте идентификатор из каталога и добавьте его в список моделей Cursor без сокращений.
- Проверьте чат
Откройте 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.