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

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

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

Установленный Cherry Studio: загрузите его с официального сайта.
API-ключ BeatAPI: создайте его в Dashboard → API Keys.

Шаг 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`

Укажите 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 и на странице цен. Добавьте нужные модели; переключаться между ними можно в списке в верхней части чата.

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

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

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

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

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

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

Добавьте модели вручную по ID в менеджере моделей. ID перечислены на странице цен; регистр важен.

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

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

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

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

Поддержка

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