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

ChatBox — кроссплатформенный клиент для общения с моделями. BeatAPI поддерживает форматы запросов OpenAI, Anthropic и Gemini, поэтому в ChatBox можно выбрать любой из трёх соответствующих типов поставщика.

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

Установленный ChatBox: версия для Windows, macOS, Linux или веб-версия.
API-ключ BeatAPI: создайте его в Dashboard → API Keys.

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

При первом запуске появится мастер настройки. Нажмите Use your own API Key or local model.

Если ChatBox уже настроен, откройте настройки значком шестерёнки слева внизу или сочетанием Ctrl+, (Cmd+, в macOS).

Шаг 2. Выберите тип поставщика и укажите адрес

Значение API Host зависит от типа поставщика: каждый клиент добавляет свой путь к запросу. Неверный адрес — самая частая причина ошибок подключения.

Тип поставщика	API Host	Для каких моделей
OpenAI API	`https://api.beatapi.io`	GPT, DeepSeek, GLM, Kimi, MiniMax, Qwen, MiMo, Hunyuan
Claude API	`https://api.beatapi.io/v1`	Модели Claude
Gemini API	`https://api.beatapi.io/`	Модели Gemini

Во всех трёх случаях в API Key указывается один и тот же ключ BeatAPI.

Выберите тип поставщика, соответствующий формату из справочника вашего семейства моделей. Не все модели поддерживают все форматы. Адреса различаются, потому что тип OpenAI добавляет /v1/chat/completions, Claude — /messages, а Gemini — v1beta/models/.... Все сочетания из таблицы ведут к существующему методу API BeatAPI.

Шаг 3. Выберите модель

Выберите модель из списка или введите её ID, если список ещё не обновился.

ID модели	Тип поставщика	Для каких задач подходит
`gpt-6-astra`	OpenAI API	Новое поколение OpenAI
`gpt-5.6-terra`	OpenAI API	Повседневное общение с балансом качества и стоимости
`claude-fable-5-1`	Claude API	Новое поколение Claude
`claude-haiku-4-5-20251001`	Claude API	Быстрые и недорогие ответы
`gemini-3.7-flash`	Gemini API	Быстрая работа с разными типами входных данных
`deepseek-v4-pro-0813`	OpenAI API	Сложные рассуждения по невысокой цене
`glm-5.3-flash`	OpenAI API	Самый дешёвый вариант для большого числа сообщений

Полный каталог приведён в разделе Text API и на странице цен.

Необязательные параметры

Параметр	На что влияет	Рекомендуемое значение
Temperature	Случайность ответа	`0.7` для творчества, `0.3` для точных ответов
Max Tokens	Максимальная длина ответа	2000–4000
Top P	Выбор токенов по суммарной вероятности	`0.9`

Ограничение Max Tokens — простой способ контролировать расходы: в большинстве диалогов выходные токены составляют более дорогую часть запроса.

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

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

Сверьте API Host с таблицей выше: наличие /v1 зависит от типа поставщика.
Убедитесь, что ключ активен, в Dashboard → API Keys.

Модели BeatAPI не отображаются в списке

Введите ID прямо в поле модели. Регистр важен; список ID есть на странице цен.

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

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

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

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

Поддержка

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