> 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 к Immersive Translate

> Добавьте BeatAPI как свой сервис перевода в браузерное расширение Immersive Translate для двуязычных страниц, PDF и субтитров.

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

Immersive Translate показывает двуязычные веб-страницы, PDF и субтитры к видео. Расширение принимает OpenAI-совместимый адрес API как свой сервис перевода, поэтому к нему можно подключить BeatAPI напрямую.

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

1. **Установленное расширение** из Chrome Web Store, Edge Add-ons, Firefox Add-ons или с официального сайта.
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

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

Нажмите значок Immersive Translate на панели браузера, затем **Settings** слева внизу всплывающего окна. В меню слева выберите **Translation Services**.

## Шаг 2. Добавьте BeatAPI как свой сервис

Нажмите **+ Add Custom Translation Service** вверху списка и заполните поля:

| Поле                    | Значение                                     |
| ----------------------- | -------------------------------------------- |
| Service name            | `BeatAPI`                                    |
| APIKEY                  | Ваш API-ключ BeatAPI                         |
| Model                   | ID модели, например `glm-5.3-flash`          |
| Custom API endpoint     | `https://api.beatapi.io/v1/chat/completions` |
| Max requests per second | `3`–`5`                                      |

> **Note**
>
> В этом поле нужен **полный адрес метода**, а не базовый URL: `https://api.beatapi.io/v1/chat/completions`, включая путь. В отличие от других описанных интеграций, одного `https://api.beatapi.io/v1` здесь недостаточно.

Сохраните настройки, вернитесь во всплывающее окно расширения и выберите **BeatAPI** в списке Translation Service.

## Шаг 3. Переводите материалы

* **Страница**: нажмите значок расширения и выберите перевод либо нажмите `Alt+A`.
* **PDF**: откройте PDF по ссылке в браузере и нажмите `Alt+A`. Локальный файл сначала нужно открыть в веб-просмотрщике.
* **Субтитры**: запустите видео на поддерживаемой платформе; двуязычные субтитры появятся автоматически.
* **Выделенный текст**: выделите фрагмент и воспользуйтесь панелью перевода слов. По умолчанию она вызывается через `Alt+W`.

## Выбор модели

Перевод часто создаёт большой поток однотипных запросов. Целая страница разбивается на множество небольших вызовов, поэтому выбор модели особенно сильно влияет на расходы.

| ID модели                | Для каких задач подходит                                         |
| ------------------------ | ---------------------------------------------------------------- |
| `glm-5.3-flash`          | Повседневный просмотр: самый дешёвый вариант с хорошим переводом |
| `gemini-3.7-flash`       | Быстрый перевод на многие языки                                  |
| `qwen3.8-flash`          | Страницы на китайском языке                                      |
| `deepseek-v4-flash-0731` | Недорогой массовый перевод                                       |
| `claude-sonnet-5`        | Художественные и творческие тексты, где важен стиль              |
| `gpt-5.6-terra`          | Технические и научные документы                                  |

Полный каталог приведён в разделе [Text API](/text-api) и на [странице цен](https://beatapi.io/pricing).

> **Note**
>
> Обычные платные модели DeepSeek, включая `deepseek-v4-flash-0731`, используют единый тариф круглосуточно. Только две модели DeepSeek HC (high-cache) удваивают тарифы по будням с 09:00 до 12:00 и с 14:00 до 18:00 по Пекину. Проверяйте тариф перед запланированным переводом или активным просмотром страниц в это время. Точные часы указаны в примечаниях на [странице цен](https://beatapi.io/pricing).

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

### После настройки ничего не переводится

1. Убедитесь, что **BeatAPI** выбран в списке Translation Service, а не только сохранён в настройках.
2. Нужен полный адрес `https://api.beatapi.io/v1/chat/completions`.
3. Убедитесь, что ключ активен, в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).
4. Регистр ID модели важен.

### Перевод идёт медленно или прерывается по тайм-ауту

Уменьшите **Max requests per second** до `3`. Перевод страницы запускает много параллельных вызовов; обычно задержки вызваны лимитом частоты запросов, а не моделью. Затем попробуйте более быструю модель, например `glm-5.3-flash` или `gemini-3.7-flash`.

### 429 rate_limit_exceeded

Это более явное проявление той же проблемы. Сначала уменьшите число запросов в секунду. Минутный лимит аккаунта растёт с общей суммой пополнений и отображается в панели управления.

### Перевод недостаточно качественный

Выберите более сильную модель: `claude-sonnet-5` для прозы или `gpt-5.6-terra` для технических текстов. Настройте стиль AI Expert под материал. Для повторяющихся терминов используйте словарь терминологии расширения: он помогает добиться единообразия, которого одна смена модели не гарантирует.

### 402 insufficient_credits

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

### Как следить за расходами

Создайте для расширения отдельный ключ BeatAPI. Просмотр страниц порождает множество небольших запросов; отдельный ключ позволяет отличить их от трафика приложений в `by_api_key` ответа [`GET /v1/usage`](/quick-guide) и в панели управления.

## Поддержка

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