Luna Translator の接続
難易度 🧩 中級 | インターフェース形式 OpenAI 互換 | base_url
https://byesu.com/v1
LunaTranslator は、オープンソースの GalGame / ビジュアルノベル翻訳ツールです。HOOK によるテキスト抽出や OCR 認識に対応し、大規模言語モデルを利用した AI 翻訳を組み込めます。Byesu API に接続すれば、gpt-5.5、claude-opus-4-8 などのモデルでゲームのテキストをリアルタイム翻訳できます。
はじめる前に
まず コンソール → トークン で API トークン（sk-xxxx のような形式）を作成してください。作成時には必ず正しいグループを選択してください。グループによって呼び出せるモデルや課金方式が決まります。詳しくは グループの選択 をご覧ください。
ステップ 1：Luna Translator をダウンロードしてインストールする
LunaTranslator 公式ドキュメント から最新版をダウンロードし、解凍後にメインプログラムを実行するだけです（Windows ではインストール不要のポータブル版）。
ステップ 2：大規模言語モデルのインターフェースを設定する
LunaTranslator には「ワンクリックインポート」と「手動設定」の 2 つの方法があります。まずは方法 1 を試すことをおすすめします。
方法 1（最速）：コンソールからワンクリックでインポートする
- Byesu コンソール で システム設定 → チャット設定 を開き、次のチャットジャンプリンクを追加します。
json
{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }- コンソール → トークン（Token）管理 に進み、ご自分のトークンを見つけて、「チャット」右側のドロップダウン矢印をクリックし、LunaTranslator を選択します。すると、ブラウザが自動的にクライアントを起動し、設定が書き込まれます。
- LunaTranslator で 設定 → 翻訳設定 → 大模型（大規模モデル） を開き、先ほど自動的に追加されたインターフェース設定を見つけます。
- モデルのドロップダウンボックス横にある「更新」ボタンをクリックして Byesu から利用可能なモデル一覧を取得し、いずれか（例：
gpt-5.5）を選択して保存します。 - そのインターフェース設定の左側にある有効化スイッチをオンにします。
方法 2：手動で設定する
- コンソール → トークン管理 で API Key（
sk-xxxx）をコピーします。 - LunaTranslator で 設定 → 翻訳設定 → 大模型（大規模モデル） を開き、「追加」をクリックします。
- 「大模型通用接口」（大規模モデル共通インターフェース） のテンプレートを 1 つコピーします。
- 新しいインターフェースの各フィールドに次の内容を入力します。
| フィールド | 入力する値 |
|---|---|
| API インターフェースアドレス / base_url | https://byesu.com/v1 |
| API Key | sk-xxxx（あなたのトークン） |
| モデル model | gpt-5.5（または次のステップで更新後に選択） |
- モデルボックス横の「更新」をクリックし、ドロップダウンリストから使用するモデルを選択します。
アドレスの末尾 /v1 を忘れずに
LunaTranslator は OpenAI 互換インターフェースを使用するため、base_url は必ず https://byesu.com/v1（末尾に /v1 付き）にしてください。https://byesu.com のように入力すると、インターフェースが認識されません。
ステップ 3：有効化して動作確認する
- そのインターフェース設定の左側にある有効化スイッチをオンにします。
- メイン画面に戻り、翻訳エンジンでこの大規模言語モデルのインターフェースを訳文のソースとして選択します。
- HOOK または OCR でゲームのテキストを 1 区切り取得し、訳文が正常に返ってくることを確認できれば接続成功です。
よく使うモデルの目安：
- スピード優先・コストパフォーマンス重視：
gpt-5.5 - より繊細な翻訳品質：
claude-opus-4-8 - 長文 / 多言語：
gemini-3.1-pro-high
うまくいかないときは？
- 401 / 認証エラーが出る：API Key が間違っているか、余分なスペースが含まれています。トークン管理から
sk-xxxxを改めてコピーしてください。よくあるエラー #auth を参照。 - 利用可能なチャネルがない / モデルが存在しないと表示される：現在のトークンのグループにそのモデルが含まれていません。別のモデルに変えるか、グループを調整してください。グループの選択 と よくあるエラー #no-channel を参照。
- 残高不足 / 残高が 0：トークンの割り当てを使い切っています。チャージするか、トークンの上限額を確認してください。よくあるエラー #balance を参照。
- モデル一覧を更新しても空のまま：base_url の末尾が
/v1であること、トークンが有効であることを確認してください。
その他のトラブルシューティングは よくあるエラー をご覧ください。