> 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 к ChatBox

> Настройте ChatBox для работы с BeatAPI через тип поставщика OpenAI, Claude или Gemini.

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

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

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

1. **Установленный ChatBox**: версия для Windows, macOS, Linux или веб-версия.
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

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

> **Note**
>
> Выберите тип поставщика, соответствующий формату из справочника вашего семейства моделей. Не все модели поддерживают все форматы. Адреса различаются, потому что тип 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](/text-api) и на [странице цен](https://beatapi.io/pricing).

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

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

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

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

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

1. Сверьте API Host с таблицей выше: наличие `/v1` зависит от типа поставщика.
2. Убедитесь, что ключ активен, в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

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

Введите ID прямо в поле модели. Регистр важен; список ID есть на [странице цен](https://beatapi.io/pricing).

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

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

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

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

## Поддержка

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