> 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 к Cherry Studio

> Добавьте BeatAPI как поставщика типа OpenAI в Cherry Studio и используйте модели с поддержкой Chat Completions в одном приложении.

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

Cherry Studio — настольный клиент для работы с несколькими поставщиками моделей. Добавьте BeatAPI как поставщика типа OpenAI и выберите доступные вашему аккаунту модели с поддержкой Chat Completions. Наличие модели в списке не гарантирует её совместимость с выбранным типом поставщика.

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

1. **Установленный Cherry Studio**: загрузите его с [официального сайта](https://cherry-ai.com/).
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

## Шаг 1. Откройте настройки поставщиков

Нажмите значок настроек справа вверху или `Ctrl+,` (`Cmd+,` в macOS), затем выберите **Model Service** в меню слева.

## Шаг 2. Добавьте BeatAPI

Внизу страницы Model Service нажмите **+ Add** и заполните поля:

| Поле          | Значение  |
| ------------- | --------- |
| Provider Name | `BeatAPI` |
| Provider Type | `OpenAI`  |

Нажмите **Confirm**. На панели настроек справа укажите:

| Поле    | Значение                 |
| ------- | ------------------------ |
| API Key | Ваш API-ключ BeatAPI     |
| API URL | `https://api.beatapi.io` |

> **Note**
>
> Укажите `https://api.beatapi.io` **без** `/v1` и дополнительного пути. Cherry Studio сам добавляет `/v1/chat/completions`. Если добавить `/v1` вручную, получится `/v1/v1/chat/completions`, и каждое сообщение будет возвращать 404.

Убедитесь, что переключатель поставщика BeatAPI справа вверху **включён** и подсвечен зелёным. До добавления моделей проверьте подключение кнопкой **Test**.

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

После настройки поставщика найдите раздел **Models** и нажмите **Manage**. В списке найдите нужный ID и нажмите **+**, чтобы добавить модель.

| ID модели              | Для каких задач подходит                                              |
| ---------------------- | --------------------------------------------------------------------- |
| `gpt-6-astra`          | Новое поколение OpenAI; тариф повышается при входе свыше 272K токенов |
| `gpt-5.6-terra`        | Повседневное общение с балансом качества и стоимости                  |
| `gemini-3.7-flash`     | Быстрая и недорогая работа с разными типами данных                    |
| `deepseek-v4-pro-0813` | Сложные рассуждения по невысокой цене                                 |
| `glm-5.3-flash`        | Самый дешёвый вариант для большого числа сообщений                    |
| `kimi-k3`              | Задачи с длинным контекстом                                           |
| `qwen3.8-max`          | Работа на китайском языке                                             |

Полный каталог приведён в разделе [Text API](/text-api) и на [странице цен](https://beatapi.io/pricing). Добавьте нужные модели; переключаться между ними можно в списке в верхней части чата.

## Шаг 4. Начните диалог

Вернитесь в главное окно, создайте чат кнопкой **+**, откройте список моделей вверху и выберите модель поставщика **BeatAPI**.

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

### Cherry Studio не подключается

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

### Список моделей пустой или не обновляется

Добавьте модели вручную по ID в менеджере моделей. ID перечислены на [странице цен](https://beatapi.io/pricing); регистр важен.

### Ошибки во время диалога

| Статус        | Причина                                                                                                                 | Что делать                                                                                         |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `401`         | `missing_api_key` или `invalid_api_key`: ключ отсутствует, неверен, просрочен, отключён или его лимит расходов исчерпан | Заново скопируйте ключ из панели управления                                                        |
| `402`         | `insufficient_credits`: баланс равен нулю или меньше стоимости запроса                                                  | Пополните баланс                                                                                   |
| `404`         | Неверный ID модели или API URL                                                                                          | Сверьте оба значения с инструкцией выше                                                            |
| `429`         | Превышен лимит частоты запросов                                                                                         | Подождите; лимит растёт с общей суммой пополнений                                                  |
| `500` / `503` | Временная ошибка на стороне сервиса (`internal_error`, `processing_*`)                                                  | Повторите позже, увеличивая задержку и сохранив `request_id`. См. [ошибки](/errors#text-endpoints) |

### Где посмотреть использование и расходы

Панель управления показывает вызовы, токены и расходы с разбивкой по API-ключам. Те же данные доступны через [`GET /v1/usage`](/quick-guide).

## Поддержка

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