Перейти к навигации

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

Подключение 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.

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

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

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

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

ПолеЗначение
Service nameBeatAPI
APIKEYВаш API-ключ BeatAPI
ModelID модели, например glm-5.3-flash
Custom API endpointhttps://api.beatapi.io/v1/chat/completions
Max requests per second3–5

В этом поле нужен полный адрес метода, а не базовый 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 и на странице цен.

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

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

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

  1. Убедитесь, что BeatAPI выбран в списке Translation Service, а не только сохранён в настройках.
  2. Нужен полный адрес https://api.beatapi.io/v1/chat/completions.
  3. Убедитесь, что ключ активен, в Dashboard → API Keys.
  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 и в панели управления.

Поддержка

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