Fluent Read（流暢な読書）の接続
難易度 🖱️ 簡単 | インターフェース形式 NewAPI（内蔵エンジン） | base_url
https://byesu.com
Fluent Read（流暢な読書）は、20 種類以上の翻訳エンジンと AI モデルに対応したオープンソースのブラウザ翻訳プラグインで、ネイティブレベルの対訳バイリンガル読書体験を提供します。Byesu API に接続すれば、GPT、Claude、Gemini などの大規模言語モデルを使ってウェブページを翻訳できます。
はじめる前に
まず コンソール → トークン で API トークン（sk-xxxx のような形式）を作成してください。作成時には必ず正しいグループを選択してください。グループによって呼び出せるモデルが決まり、間違って選ぶと「利用可能なチャネルがありません」というエラーになります。詳しくは グループの選択 をご覧ください。
ステップ 1：プラグインのインストール
Fluent Read は主要なブラウザに対応しています。お使いのものを選んでインストールしてください：
- Chrome：Chrome ウェブストアで「Fluent Read」を検索します。中国本土のユーザーは crxsoso.com のミラーを利用できます
- Edge：Edge アドオンストアで「流畅阅读」（Fluent Read）を検索します
- Firefox：Firefox アドオンストアで「Fluent Read」を検索します
インストールすると、ブラウザのツールバーに Fluent Read のアイコンが表示されます。
ステップ 2：Byesu API の設定
ツールバーの Fluent Read アイコンをクリックして設定ページを開きます。Fluent Read には NewAPI 翻訳エンジンが内蔵されており（Byesu はまさに NewAPI アーキテクチャです）、これをそのまま選択して、以下の表に従って入力します：
| 項目 | 入力内容 |
|---|---|
| 翻訳サービス | NewAPI を選択 |
| NewAPI インターフェース | https://byesu.com（/v1 なし、パスはプラグインが自動的に補完します） |
| アクセストークン | あなたの byesu トークン（sk-xxxx のような形式） |
| モデル | リストから選択するか、「カスタムモデル」を選択して下記のモデル名を入力 |
| カスタムモデル | 例：gpt-5.5 |
おすすめのモデル
翻訳のようなタスクは速度とコストパフォーマンスが重要になるため、用途に応じて選んでください：
gpt-5.5—— 汎用翻訳、速度と品質のバランスが良好claude-opus-4-8—— 長文や専門的なドキュメントの翻訳品質に優れるgemini-3.1-pro-high—— 多言語・長いコンテキストで優れたパフォーマンスを発揮
モデル名はコンソールの「利用可能なモデル」にある名称と完全に一致している必要があり、かつあなたのトークンで選択したグループの範囲内である必要があります。
インターフェースアドレスを間違えないように
NewAPI エンジンを選んだ場合、「NewAPI インターフェース」には /v1 なしの https://byesu.com を入力してください。パスはプラグイン側で自動的に組み立てられるため、/v1 を付けてしまうと /v1/v1 になって接続できません。「OpenAI / カスタム OpenAI 互換」エンジンを使う場合にのみ、インターフェースアドレスに /v1 を付ける必要があります（https://byesu.com/v1）。どちらでもうまくいかない場合は、下記の「うまくいかないときは？」を参照して確認してください。
ステップ 3：動作確認
- 設定を保存します。
- 任意の外国語のウェブページ（例えば英語の記事）を開きます。
- Fluent Read のアイコンをクリックして「このページを翻訳」を選ぶか、選択範囲の翻訳機能を使います。
- ページに日本語との対訳が表示されれば、接続成功です。
なかなか訳文が表示されない場合は、まずブラウザの右クリックメニュー → 検証 → Console を開いてエラーが出ていないか確認し、それから下記を参照して確認してください。
うまくいかないときは？
- 401 / トークンが無効：トークンが完全にコピーされているか（
sk-プレフィックスを含む）、余分なスペースが入っていないかを確認してください。よくあるエラー #auth をご覧ください。 - 利用可能なチャネルがありません / no channel：多くの場合、トークンのグループ選択が間違っているため、そのグループに入力したモデルが存在しないことが原因です。正しいグループに変更するか、グループ内にあるモデル名に変更してください。グループの選択 と よくあるエラー #no-channel をご覧ください。
- 残高不足 / 残高が足りない：アカウントまたはトークンの残高を使い切っています。コンソールでチャージするか、トークンの上限を調整してください。よくあるエラー #balance をご覧ください。
- リクエストタイムアウト / 訳文が出ない：NewAPI エンジンの場合、インターフェースアドレスが
https://byesu.com（/v1なし）になっているか確認してください。OpenAI 互換エンジンの場合のみhttps://byesu.com/v1です。他のプレースホルダーのアドレスを書かないようにしてください。
その他の対処法については よくあるエラー をご覧ください。