Подключение BeatAPI к Cursor

Cursor — редактор кода с ИИ. В настройках моделей можно указать OpenAI-совместимый адрес API и подключить BeatAPI без дополнительных расширений.

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

Установленный Cursor.
API-ключ BeatAPI: создайте его в Dashboard → API Keys.

Шаг 1. Откройте настройки моделей

Откройте настройки значком шестерёнки справа вверху или сочетанием Cmd+Shift+J в macOS, Ctrl+Shift+J в Windows и Linux. Выберите Models в боковом меню.

Шаг 2. Укажите адрес BeatAPI

Найдите раздел OpenAI API Key, включите Override OpenAI Base URL и укажите:

Настройка	Значение
API Key	Ваш API-ключ BeatAPI
Base URL	`https://api.beatapi.io/v1`

Сохраните настройки, отправьте небольшой поддерживаемый запрос в чат и найдите соответствующую запись в статистике BeatAPI.

Используйте https://api.beatapi.io/v1, как в таблице. Дополнительный путь метода может привести к неверному URL. Если проверка не прошла, изучите запрос и статистику использования BeatAPI.

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

Шаг 3. Добавьте нужные модели

Cursor ведёт собственный список моделей; наличие модели в нём не подтверждает работу с вашим ключом. Согласно руководству Cursor по собственным API-ключам, собственные ключи OpenAI используются только для поддерживаемых обычных моделей чата без режима рассуждения. Проверьте текущие ограничения Cursor, выберите точный ID модели, доступной аккаунту BeatAPI через GET /v1/models, и отправьте небольшой запрос перед использованием интеграции. OpenAI-совместимость BeatAPI сама по себе не гарантирует, что модель Claude или модель с рассуждением заработает через переопределение ключа OpenAI в Cursor.

Собственный ключ применяется к поддерживаемым запросам чата. Автодополнение Cursor Tab продолжает использовать встроенную модель Cursor. Успешное подключение своей модели не означает, что все функции Cursor обращаются к BeatAPI. Проверяйте фактические запросы в статистике BeatAPI.

Шаг 4. Пользуйтесь редактором

Чат: нажмите Cmd+L / Ctrl+L и задайте вопрос или опишите задачу.
Правка в редакторе: выделите код и нажмите Cmd+K / Ctrl+K. Проверьте, направляют ли выбранная модель и текущая версия Cursor этот запрос через ваш ключ.
Автодополнение Tab продолжает использовать встроенную модель Cursor, а не BeatAPI.

Ссылайтесь на файлы через @filename, а на каталоги — через @folder, чтобы передать модели нужный контекст, а не заставлять её угадывать содержимое открытого файла.

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

Cursor не подключается к BeatAPI

Base URL должен быть точно https://api.beatapi.io/v1.
Ключ должен быть активен. Проверьте Dashboard → API Keys.
Если используется корпоративный прокси, разрешите доступ к api.beatapi.io.

Модель есть в списке, но не работает

Cursor использует собственный список. Запросы будут работать только для ID, которые действительно доступны аккаунту. Актуальный каталог есть на странице цен.

402 insufficient_credits

Баланс равен нулю или меньше стоимости запроса. Пополните его в панели управления.

429 rate_limit_exceeded

Ключ превысил лимит частоты запросов. Проверьте его статистику в BeatAPI, выберите поддерживаемую модель или измените лимит ключа в панели управления. Автодополнение Cursor Tab не использует этого поставщика.

Ответы приходят медленно

Для поддерживаемых запросов чата попробуйте более лёгкую модель, выделяйте меньше кода и используйте ссылки @file вместо вставки больших фрагментов.

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

Поддержка

Создайте обращение в панели управления и укажите request_id из ответа с ошибкой.