> 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.

# Immersive Translate で BeatAPI を使う

> ブラウザー拡張機能 Immersive Translate に BeatAPI を追加し、ページ、PDF、字幕を対訳表示します。

# Immersive Translate で BeatAPI を使う

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

## 前提条件

1. **拡張機能がインストールされていること。** Chrome ウェブストア、Edge Add-ons、Firefox Add-ons、または公式サイトから入手します。
2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

## ステップ 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`                                      |

> **Note**
>
> この項目では、ベース 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](/text-api) と[料金ページ](https://beatapi.io/pricing)に掲載しています。

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

## よくある質問

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

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

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

### 料金を確認するには

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

## サポート

[ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。