---
title: "BYOK 设置——使用自己的 API 密钥 | VoxisLive"
description: "分步设置 VoxisLive BYOK 解锁：添加您的 Google Gemini 密钥，或粘贴完整的 Alibaba Qwen 凭据文件，然后开始翻译。"
url: https://voxislive.com/zh/byok-setup
language: "zh-CN"
source_html: https://voxislive.com/zh/byok-setup
site: "Voxis — real-time voice translation"
og_image: https://voxislive.com/assets/og.png
generated_by: voxislive-markdown-pipeline
---

[首页](https://voxislive.com/zh/) · / · BYOK 设置

BYOK

# 设置您自己的 API 密钥

BYOK 解锁让 Voxis 可以使用您自己的 Google Gemini 或 Alibaba Qwen API 密钥运行——一次购买即可同时用于 Windows 应用和 Chrome 扩展。本页介绍如何第一次就把密钥设置正确。

该解锁为一次性购买，价格 **$99.99**，同时适用于两个应用，并且**一经激活即不可退款**。从激活起，翻译将使用您自己的密钥运行，账户中剩余的任何 Voxis 预付分钟数将无法再使用。请参阅[价格](https://voxislive.com/zh/pricing#byok)和[退款政策](https://voxislive.com/zh/refund)。

## 1. 开始之前

- 您的账户需要有 **BYOK 解锁**——这是一次性购买，请参阅[价格](https://voxislive.com/zh/pricing#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 会自动为其选择路由。

常见问题

## 常见问题

### 我的 API 密钥会发送给 Voxis 吗？

不会。密钥只存储在您的设备上——在应用中使用 Windows DPAPI 加密，在浏览器中保存在扩展的本地存储里。翻译会话直接从您的设备连接到 Google 或 Alibaba；Voxis 只验证您的账户是否拥有 BYOK 许可。

### BYOK 会话会消耗我的 Voxis 分钟数吗？

不会。BYOK 会话使用您自己的密钥运行，由您的提供方计费；它们绝不会消耗 Voxis 分钟数。您激活 BYOK 时账户中仍有的预付分钟数将无法再使用。

### 一次购买能同时用于应用和扩展吗？

可以。许可绑定在您的账户上，因此同一次购买即可同时解锁 Windows 应用和 Chrome 扩展。

### 我可以同时保存 Gemini 密钥和 Qwen 密钥吗？

可以。两个密钥槽位可以并存，Voxis 会按目标语言选择引擎。输入框为空时保存不会改变任何内容，点击“清除”则会删除已保存的密钥。

## 延伸阅读

[浏览器扩展 · 实时听到任何标签页以您的语言翻译并说出。](https://voxislive.com/zh/extension) · [价格 · 方案、分钟套餐，以及一次性的 BYOK 解锁。](https://voxislive.com/zh/pricing#byok) · [许可说明 · 商业条款，以及公开代码库允许和不允许的事项。](https://voxislive.com/zh/licensing)


## Structured data (JSON-LD)

```json
[
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "@id": "https://voxislive.com/#org",
    "name": "VoxisLive",
    "legalName": "VoxisLive Limited",
    "alternateName": [
      "Voxis",
      "Voxis Live"
    ],
    "url": "https://voxislive.com/",
    "logo": {
      "@type": "ImageObject",
      "url": "https://voxislive.com/assets/voxis-mark-512.png",
      "width": 512,
      "height": 512
    },
    "identifier": "UK Companies House 17500296",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "71-75 Shelton Street, Covent Garden",
      "addressLocality": "London",
      "postalCode": "WC2H 9JQ",
      "addressCountry": "GB"
    },
    "contactPoint": [
      {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@voxislive.com",
        "url": "https://voxislive.com/contact",
        "availableLanguage": [
          "en",
          "tr",
          "es",
          "de",
          "fr",
          "pt",
          "ko",
          "ja",
          "zh",
          "ru"
        ]
      }
    ],
    "sameAs": [
      "https://apps.microsoft.com/store/detail/9P5Z0KVS58RS",
      "https://snapcraft.io/voxis",
      "https://chromewebstore.google.com/detail/voxis-%E2%80%94-live-translate/eaoplhkoomnlgfhcjeccgkhnkodkfbjn",
      "https://github.com/VoxisLive/voxislive",
      "https://www.reddit.com/r/LiveTranslation/",
      "https://www.reddit.com/r/LiveTranslation/wiki/index",
      "https://www.youtube.com/@VoxisLiveApp",
      "https://www.wikidata.org/wiki/Q141727138",
      "https://find-and-update.company-information.service.gov.uk/company/17500296",
      "https://www.google.com/search?kgmid=/g/11zyg5wsj8",
      "https://www.linkedin.com/company/voxislive/"
    ]
  },
  {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "首页",
            "item": "https://voxislive.com/zh/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "BYOK 设置",
            "item": "https://voxislive.com/zh/byok-setup"
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "我的 API 密钥会发送给 Voxis 吗？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "不会。密钥只存储在您的设备上——在应用中使用 Windows DPAPI 加密，在浏览器中保存在扩展的本地存储里。翻译会话直接从您的设备连接到 Google 或 Alibaba；Voxis 只验证您的账户是否拥有 BYOK 许可。"
            }
          },
          {
            "@type": "Question",
            "name": "BYOK 会话会消耗我的 Voxis 分钟数吗？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "不会。BYOK 会话使用您自己的密钥运行，由您的提供方计费；它们绝不会消耗 Voxis 分钟数。您激活 BYOK 时账户中仍有的预付分钟数将无法再使用。"
            }
          },
          {
            "@type": "Question",
            "name": "一次购买能同时用于应用和扩展吗？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "可以。许可绑定在您的账户上，因此同一次购买即可同时解锁 Windows 应用和 Chrome 扩展。"
            }
          },
          {
            "@type": "Question",
            "name": "我可以同时保存 Gemini 密钥和 Qwen 密钥吗？",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "可以。两个密钥槽位可以并存，Voxis 会按目标语言选择引擎。输入框为空时保存不会改变任何内容，点击“清除”则会删除已保存的密钥。"
            }
          }
        ]
      },
      {
        "@type": "WebPage",
        "name": "BYOK 设置——使用自己的 API 密钥 | VoxisLive",
        "url": "https://voxislive.com/zh/byok-setup",
        "description": "分步设置 VoxisLive BYOK 解锁：添加您的 Google Gemini 密钥，或粘贴完整的 Alibaba Qwen 凭据文件，然后开始翻译。",
        "inLanguage": "zh-CN",
        "dateModified": "2026-10-21",
        "isPartOf": {
          "@type": "WebSite",
          "name": "VoxisLive",
          "url": "https://voxislive.com/"
        }
      }
    ]
  }
]
```
