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

你需要准备什么

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

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

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

千问（阿里云百炼）

Parley 的千问 Live 通过 WebSocket 调用模型 qwen3.8-livetranslate-flash-realtime ，连接你自己的百炼 / Model Studio 业务空间。 北京和国际站（新加坡）都可配置 ——请在桌面端选择与密钥、业务空间一致的地域。Parley 需要两个值：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 field. For Qwen, also paste your Beijing or international workspace ID (or a full API URL for that region) into the 业务空间 ID 或 API URL 输入框。然后点击 保存

千问设置里也有一行 业务空间 ID row (Beijing or international) where the same value can be edited later. The dialog rejects keys shorter than 12 characters with “This key looks incomplete. Check that you pasted all of it.”

你也可以在应用内打开本指南：在同一设置页中，使用 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 显示或报告的提示信息，不同语言下的措辞可能略有差异。

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