1. はじめる前に
- アカウントに BYOK アンロックが必要です。1回限りの購入です。料金をご覧ください。購入したアカウントで、アプリまたは拡張機能にログインしてください。
- プロバイダーからキーを取得します。Gemini は Google AI Studio から、Qwen は Alibaba Cloud Model Studio（インターナショナル版）から取得します。
- キーの入力欄は1つです。Voxis はキー自体からプロバイダーを判別します。
AIza…は Gemini、sk-…は Qwen です。両方を並べて保存することもでき、その場合 Voxis は翻訳先の言語ごとに最適なエンジンを選びます（Qwen は約29の翻訳先を自然な声で話し、Gemini は79すべてをカバーします）。
2. Gemini キーを追加する
Google AI Studio で API キーを作成し、AIza… の値をコピーして、キーの入力欄に貼り付けて保存します。Gemini ではワークスペースの行は表示されませんが、それで正常です。Gemini にはワークスペースは必要ありません。
3. Qwen キーを追加する — ファイルを丸ごと貼り付ける
Model Studio では、キーが小さなダウンロード用の認証情報ファイル（CSV）として渡されます。すべてがうまくいくための唯一のルールがあります。
ファイルのパスを貼り付けないでください。キーだけを貼り付けるのもいけません。ファイルを開き、内容をすべて選択してコピーし、そのすべてをキーの入力欄に貼り付けてください。
Voxis は、貼り付けた内容から API キーとワークスペースの両方を一度に読み取ります。ワークスペースが重要なのは、Qwen のキーがワークスペースに属しているためで、特にブラウザでは、ワークスペースが接続先のアドレスそのものの一部になります。これがないと、キーはまったく接続できません。
sk-…のキーだけを貼り付けた場合、Voxis はワークスペースの名前を尋ねます。- ファイルのパス（
C:\Users\…\key.csvなど）を貼り付けた場合は、「API キーを貼り付けてください。」という警告が表示されます。代わりにファイルの内容を貼り付けてください。 - キーはインターナショナル版の Model Studio で作成してください。別のリージョンで作成したキーは、無効なキーのように見える形で失敗します。
4. 翻訳を開始する
拡張機能では、動画を再生しているタブを開いて Voxis のアイコンをクリックし、「開始」ボタンの下の行を確認します。そこには翻訳されるタブの名前（「開始するとこのタブを翻訳します: …」）が表示されます。違うタブの名前が表示されている場合は、動画のタブに切り替えて、そこでポップアップを開いてください。そのうえで「開始」を押します。Windows アプリでは、「動画・ゲーム」か「ミーティング」を選んで「開始」を押します。最初の翻訳が届くまでに数秒かかることがあります。
うまくいかない場合
- 「API キーを貼り付けてください。」という警告 — ファイルのパスか、ただのテキストを貼り付けています。ファイルを開いて、その内容を貼り付けてください。
- 「開始」の直後にワークスペースを示すエラー — ワークスペースが指定されていません。認証情報ファイルを丸ごと貼り付け直してください。
- キーとワークスペースの組み合わせについて、すぐに出る具体的なエラー — 両者が対応していないか、リージョンが違っています。認証情報ファイルをダウンロードし直して、もう一度貼り付けてください。
- 接続されているのに音が出ない — 動画を再生しているタブで「開始」を押したか、そして実際に再生されているかを確認してください。
- Qwen キーだけだと開始しない言語がある — その翻訳先には Qwen の声がありません。Gemini キーも追加してください。Voxis が自動で振り分けます。