Immersive Translate で BeatAPI を使う

Immersive Translate は Web ページ、PDF、動画字幕を対訳表示します。カスタム翻訳サービスとして OpenAI 互換のエンドポイントを指定できるため、BeatAPI を直接利用できます。

前提条件

拡張機能がインストールされていること。 Chrome ウェブストア、Edge Add-ons、Firefox Add-ons、または公式サイトから入手します。
BeatAPI API キー。 ダッシュボード → API キーで作成します。

ステップ 1：設定を開く

ブラウザーのツールバーで Immersive Translate アイコンを押し、ポップアップ左下の Settings、左メニューの Translation Services を順に選択します。

ステップ 2：BeatAPI をカスタムサービスとして追加する

一覧上部の + Add Custom Translation Service を押し、次を入力します。

項目	値
Service name	`BeatAPI`
APIKEY	BeatAPI API キー
Model	モデル ID。例 `glm-5.3-flash`
Custom API endpoint	`https://api.beatapi.io/v1/chat/completions`
Max requests per second	`3`–`5`

この項目では、ベース URL ではなく完全なエンドポイントを指定します。パスを含む https://api.beatapi.io/v1/chat/completions が必要です。このサイトの連携例の中では、https://api.beatapi.io/v1 だけでは正しくない例です。

保存後、拡張機能のポップアップに戻り、Translation Service のドロップダウンで BeatAPI を選びます。

ステップ 3：翻訳する

ページは拡張機能のアイコンから翻訳を選ぶか、Alt+A を押します。
PDF はオンラインの PDF をブラウザーで開き、Alt+A を押します。ローカルファイルは先に Web ビューアーで開く必要があります。
字幕は対応プラットフォームで動画を再生すると、自動で対訳表示されます。
選択範囲はテキストを選び、単語翻訳パネルを使います。初期ショートカットは Alt+W です。

モデルを選ぶ

翻訳は、多くの利用者にとって呼び出し回数が多く、繰り返しの多い処理です。1 ページでも多数の小さなリクエストになるため、モデル選択の料金への影響が特に大きくなります。

モデル 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-v4-flash-0731 を含む通常の有料 DeepSeek モデルは、時間帯を問わず同じ料金です。平日の北京時間 09:00–12:00 と 14:00–18:00 に 2 倍になるのは 2 つの DeepSeek HC（高キャッシュ）モデルだけです。定期実行や平日日中の大量閲覧で使う前に、単価を確認してください。正確な時間は料金ページの注記に記載しています。

よくある質問

設定しても翻訳されません

保存しただけでなく、Translation Service のドロップダウンで BeatAPI を選択したか確認します。
エンドポイントは完全なパス https://api.beatapi.io/v1/chat/completions を指定します。
ダッシュボード → API キーでキーが有効か確認します。
モデル 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

残高が 0、またはリクエストの料金に不足しています。ダッシュボードからチャージしてください。

料金を確認するには

拡張機能専用の BeatAPI キーを使ってください。閲覧では多数の小さな呼び出しが発生します。専用キーなら GET /v1/usage の by_api_key やダッシュボードで、アプリケーションの通信と分けて確認できます。

サポート

ダッシュボードからチケットを作成し、失敗したレスポンスの request_id を添えてください。