千问与豆包 API Key 申请与配置教程
一步一步配置你自己的 API 密钥。

你需要准备什么

在个人 API 模式下，Parley 桌面端会用你自己的凭据直接连接服务商。请先准备好：

• 已生效个人 API 使用权的 Parley 账户，并已在桌面端登录。只有已登录且已买断的账户才会看到 API 密钥设置。
• 所选服务商的账号。 千问使用阿里云，豆包使用火山引擎。开始时只需要其中一家。服务商可能要求完成实名认证。
• 该账号有免费额度或可用余额。 如果服务商已无额度可扣，有效的密钥也无法使用。

Gemini Live 与 OpenAI Realtime 在应用中标注为“即将上架”，目前无法选择，因此暂时无需为它们配置密钥。

千问（阿里云百炼）

Parley 的千问 Live 通过 WebSocket 调用模型 qwen3.8-livetranslate-flash-realtime ，连接你自己位于 华北2（北京） 地域的百炼业务空间。你需要提供两个值：API 密钥和北京业务空间 ID。

获取千问 API 密钥与业务空间 ID

1. 打开 百炼控制台（中国站） ，用阿里云账号登录。若弹出服务协议，同意后即自动开通百炼；没有弹出则说明已开通。如提示尚未实名认证，请先完成实名认证。
2. 在右上角的地域选择中选择 华北2（北京） 。每个地域有独立的 API 密钥、接入域名和模型，不能混用。
3. 打开 北京地域的 API Key 页面 ，点击“创建 API Key”。除非需要隔离，否则保持默认的归属账号和默认业务空间。权限建议选择“全部”；如果通过自定义权限限制模型范围，请包含 qwen3.8-livetranslate-flash-realtime。点击密钥旁的复制图标复制。如果无法创建，请联系超级管理员或业务空间管理员。
4. 在北京地域打开 业务空间管理 ，复制创建密钥时所在业务空间的 ID（建议使用同一业务空间）。如果你已有形如 https://<ID>.cn-beijing.maas.aliyuncs.com/…的 Base URL，可以把整个 URL 粘贴到 Parley，应用会自动提取 ID。
5. 确认额度。新开通的账号仅在北京地域有新人免费额度，按阿里云规则有效期 90 天，且每个模型的额度相互独立。额度的使用方式及“免费额度用完即停”开关，请见 新人免费额度 。

然后按照 在 Parley 中填写密钥操作。官方参考：

• 获取与配置 API Key
• 首次调用千问 API（含业务空间 ID）
• qwen3.8-livetranslate-flash-realtime 模型信息与价格
• 通过 WebSocket 实现实时音视频翻译

豆包（火山引擎）

Parley 的豆包同声传译使用火山引擎豆包同声传译 2.0 服务，地址为 wss://openspeech.bytedance.com/api/v4/ast/v2/translate，资源 ID 固定为 volc.service_type.10053。使用新版火山引擎控制台时，只需要一个 API 密钥。

获取豆包 API 密钥

1. 在 火山引擎控制台注册或登录。新用户需先完成实名认证才能继续使用。
2. 打开 豆包语音新版控制台。请确认使用的是新版控制台：左上角的下拉框可在新旧版之间切换。旧版使用 App ID 与 Access Token，Parley 不使用这种方式。
3. 开通服务。新账号可使用“服务开通”快捷入口，一键为 default 项目开通全部模型并获得免费试用礼包（仅首次开通时赠送）。否则，请在左侧导航进入“开通管理”，为你的项目开通豆包同声传译模型。
4. 创建密钥。在左侧导航进入“API Key管理”并点击“创建 API Key”，也可以直接打开 API Key 管理 。复制密钥。请在开通服务的同一个项目下创建，因为资源与密钥都与项目绑定。
5. 确认计费。优先使用免费试用额度，用完后按量后付费计费，除非你购买了资源包。详见 计费说明

然后按照 在 Parley 中填写密钥操作。官方参考：

• 快速入门（新版控制台）
• API Key 使用
• 同声传译 2.0 API 接入文档
• 计费说明

在 Parley 中填写密钥

1. 更新并打开 Parley 桌面端，用持有个人 API 使用权的账号登录。
2. 在开始界面把“计费方式”设为 个人 API。另一个选项 Parley 服务使用 Parley 自己的凭据，无需密钥。
3. 打开“设置”，进入 翻译服务 标签，选择 豆包同声传译 或 千问 Live
4. 在该服务的设置中找到 API 密钥 一行。未配置时显示“未配置密钥”。点击 设置密钥 （配置过之后按钮变为 更换密钥 ，该行显示“密钥已配置”）。
5. 在 设置 API 密钥 对话框中，把密钥粘贴到 粘贴 API Key 输入框。千问还需把北京业务空间 ID（或完整的北京 API URL）粘贴到 业务空间 ID 或 API URL 输入框。然后点击 保存

千问设置中还有一行 北京业务空间 ID ，之后可在此修改同一个值。对话框会拒绝少于 12 个字符的密钥，并提示“密钥看起来不完整，请检查是否整段粘贴”。

你也可以在应用内打开本指南：在同一设置页中，使用 API 密钥配置指南 这一行。

密钥保存在哪里

密钥分别保存在每台电脑上，换电脑需重新填写。密钥不会写入 settings.toml

可选：环境变量

如果设置了非空的环境变量，它会优先于应用中保存的密钥；业务空间 ID 的环境变量同样优先于 settings.toml

• Windows（PowerShell，之后重启 Parley）： [Environment]::SetEnvironmentVariable("PARLEY_DOUBAO_API_KEY", "<your key>", "User")
• macOS（终端，并在同一终端中启动 Parley）： export PARLEY_DOUBAO_API_KEY='<your key>'。从 Dock 或 Finder 打开的应用不会读取 shell 配置文件，因此在 macOS 上用应用内对话框更省事。

确认配置成功

1. 在“设置 → 翻译服务”中，该服务的 API 密钥 一行显示“密钥已配置”。千问的 北京业务空间 ID 一行也会显示你的 ID。
2. 确认开始界面的“计费方式”为 个人 API ，并已选中你配置的服务。
3. 选择一个内置音色，开始约 30 秒的短测试。说一句话，应出现字幕并播放译音。Parley 没有单独的“测试连接”按钮，用一次简短的真实会话来测试。
4. 查看服务商的用量页面。千问： 账单详情；豆包：豆包语音控制台的“开通管理”可查看免费额度与余量。这次测试应出现在其中，说明计费的就是你配置的密钥。

费用与限额

价格按各供应商文档在上述核实日公布的人民币标价，可能变动。音频会换成 token：豆包大约每秒输入音频 6.25 token、每秒输出音频 25 token。使用自己的豆包密钥时，双向会议可同时打开最多两个供应商连接（说与听各一），请按两个连接预估供应商用量——这是云供应商账单，不是 Parley 托管钱包计费。Parley 托管翻译仍按一次连接会话计费（含双向）。请在依赖前查看供应商当前页面。

千问提示：未实名认证的账号免费额度用完后将无法继续调用；已认证账号会自动转为按量付费，除非你开启了“免费额度用完即停”，此时调用会返回 HTTP 403 与错误码 AllocationQuota.FreeTierOnly

保护好你的密钥

• 把密钥当作密码。不要发在聊天、邮件、截图或工单中。
• 为 Parley 单独创建一个密钥，这样撤销时不会影响其他工具。
• 如果怀疑密钥泄露，请立即在服务商控制台删除或禁用。阿里云密钥删除后立即失效；火山引擎支持在控制台禁用或删除密钥。
• 千问可以在密钥的自定义权限中限制可调用的模型，也可以选择限制 IP 地址。
• 在 Windows 上，保存的密钥会针对你的 Windows 用户加密。在 macOS 上是仅当前用户可读的私有文件，并未加密。请勿在共用或不可信的电脑上使用。
• 对大多数人来说，在应用内保存最安全。环境变量对以你身份运行的其他程序可见。

常见问题排查

下表列出的是 Parley 显示或报告的提示信息，不同语言下的措辞可能略有差异。

仍未解决？请写信到页脚的支持邮箱，并附上你看到的提示信息。请勿附带密钥本身。