> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

> Настройте BeatAPI как своего поставщика моделей для поддерживаемых запросов чата Cursor. Учитывайте отдельные ограничения Cursor Tab.

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

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

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

1. **Установленный Cursor.**
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

## Шаг 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.

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

> **Note**
>
> Переопределение OpenAI Base URL в Cursor может затронуть и встроенные модели. Выключайте его, когда возвращаетесь к моделям под управлением Cursor. См. [пояснение сотрудника Cursor](https://forum.cursor.com/t/include-openrouter-support-within-api-keys-supported-services/5347/10) и проверьте актуальное поведение, прежде чем сочетать оба способа подключения.

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

Cursor ведёт собственный список моделей; наличие модели в нём не подтверждает работу с вашим ключом. Согласно [руководству Cursor по собственным API-ключам](https://prod.cursor.com/help/models-and-usage/api-keys), собственные ключи 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

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

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

Cursor использует собственный список. Запросы будут работать только для ID, которые действительно доступны аккаунту. Актуальный каталог есть на [странице цен](https://beatapi.io/pricing).

### 402 insufficient_credits

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

### 429 rate_limit_exceeded

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

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

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

В актуальном [руководстве Cursor по собственным API-ключам](https://prod.cursor.com/help/models-and-usage/api-keys) указано, какие запросы могут использовать свой ключ. Проверяйте его снова при изменениях маршрутизации моделей в Cursor.

## Поддержка

Создайте обращение в [панели управления](https://beatapi.io/dashboard) и укажите `request_id` из ответа с ошибкой.