1. 开始之前
- 您的账户需要有 BYOK 解锁——这是一次性购买，请参阅价格。请使用购买它的账户登录应用或扩展。
- 从提供方获取密钥：Gemini 来自 Google AI Studio，Qwen 来自 Alibaba Cloud Model Studio（国际版）。
- 只有一个密钥输入框。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 会自动为其选择路由。