BYOK：自带密钥

又要订阅？不。

我们先把这个问题说清楚，因为你心里已经在想了。

你有 Chess.com 会员，可能还给 Lichess Patron 捐过款。Spotify、Netflix、iCloud，可能还订了一两份报纸。密码管理器、云存储，还有那个三个月前忘了取消的应用。现在每个软件都想收你每月 8-15 美元，单独看每笔都不多，但加在一起你会发现每个月花了 200 美元在那些只用了一半的订阅上。

我们理解，我们也深有体会。

En Parlant~ 是自由软件。GPL-3.0，开源，无需注册账号，没有试用期，没有”升级到专业版”。核心应用——引擎分析、棋局数据库、谜题、棋盘编辑器等所有功能——完全免费。

但有些功能确实需要云服务才能运行。逼真的语音解说需要语音合成 API。这些服务运行起来需要成本，总得有人来承担。

传统的做法是：我们付费，然后以订阅的形式将成本转嫁给你。BYOK 的做法不同：你直接按云服务商的费率、按实际用量向其付费。没有中间商加价，没有月费起步价，与我们之间完全没有计费关系。

这就是本页要说明的内容。

什么是 BYOK？

BYOK——Bring Your Own Key（自带密钥）——意味着你使用自己的账号和 API 密钥直接连接云服务，而不是通过我们作为中间人。En Parlant~ 的云端功能采用 BYOK 模式：

• 文字转语音解说 —— 使用你的 ElevenLabs 或 Google Cloud TTS 密钥

你的请求从你的电脑直接发送到服务商。我们不会看到你的密钥，不会接触你的流量，也不会向你收费。

你按实际用量直接向服务商付费。我们只提供软件。

这一模式是如何形成的

BYOK 模式并非源于某个单一决定，而是在行业摸索如何将强大的云服务整合进工具、同时不创造不可持续商业模式的过程中逐步演化而来的。

第一阶段：托管时代（2022-2023）

当语音合成、翻译和 AI 的云端 API 开始普及时，每个想使用这些功能的应用都采用相同的架构：开发者注册 API 账号，按请求付费，并代表用户代理所有请求。开发者要么自行承担成本，要么通过订阅转嫁，或者通过配额限制使用量。

这对有收入的公司来说行得通，但对开源项目和独立开发者来说是灾难。一个受欢迎的免费工具可能一夜之间产生数千美元的 API 账单。一些项目关闭了相关功能，另一些加了等候名单，还有一些则烧光了积蓄。

第二阶段：订阅代理（2023-2024）

下一代方案尝试了折中：开发者运行代理服务器，用户支付月费，月费覆盖 API 成本外加一定利润。

这种方式可行，但它把每个应用开发者都变成了计费服务商。你需要支付处理、订阅管理、用量计量、计费纠纷的客户支持，还需要足够的利润空间来吸收用量峰值而不至于破产。对于有风投支持的创业公司来说，这不过是日常；但对开源维护者来说，这等于第二份工作。

第三阶段：BYOK（2024 至今）

最终的领悟很简单：如果用户可以自己注册 API 账号，而且 API 稳定且文档完善，那开发者为什么要充当中间人呢？

BYOK 去掉了中间商。应用在本地存储你的密钥，直接调用 API，服务商负责计费、速率限制和身份验证。开发者只需发布软件，用户自己控制支出。

到 2025 年底，BYOK 已成为具有云端功能的工具的标准做法：

• JetBrains 于 2025 年 12 月在其所有 IDE（IntelliJ、PyCharm、WebStorm 等）中添加了 BYOK 支持，兼容 Anthropic、OpenAI 及其他服务商。
• GitHub Copilot 于 2025 年 11 月以公开预览的形式推出了企业版 BYOK。
• Cursor，AI 代码编辑器，在其自有托管方案之外提供 BYOK 选项。
• Continue.dev，一款开源 AI 编程助手，从设计之初就以 BYOK 为核心。
• Warp，AI 驱动的终端，将 BYOK 作为核心功能。
• OpenHands，一款开源编程代理，为所有用户提供免费的 BYOK 层级。

这一模式之所以可行，是因为这些工具的目标用户——开发者、高级用户、习惯自行配置环境的人——能够轻松管理 API 账号。他们已经在管理 AWS 密钥、GitHub 令牌和 SSH 证书了，多一个 API 密钥完全不成问题。

为什么 BYOK 适合 En Parlant~

En Parlant~ 从根本上就基于 BYOK 构建。每个云端功能都采用相同的模式：

功能	服务商选项	密钥能为你带来什么
语音解说	ElevenLabs、Google Cloud TTS	自然、富有表现力的走棋与评论语音播报

每个密钥都存放在同一个位置（应用设置），以相同的方式工作（粘贴即用），遵循相同的原则：你的密钥、你的账号、你做主。

对项目而言，BYOK 意味着：

• 零基础设施成本。不需要运行服务器，不需要管理计费。
• 没有财务风险。用户激增不会变成账单激增。
• 没有速率限制的烦恼。每个用户都有各自在服务商处的配额。
• 项目可以保持完全开源和免费，无需补贴 API 使用成本。
• 我们可以添加新的云端功能而永远不需要成为计费服务商。

对用户而言，BYOK 意味着：

• 你来选择服务商。ElevenLabs 的高级 TTS 或 Google 的免费 WaveNet，随意搭配。
• 你掌控支出。随时查看费用，随时停用。
• 你的数据直接发送到你选择的服务商——不经过任何第三方代理。
• 无需订阅 En Parlant~。软件免费，你只为选择启用的云服务付费。

BYOK 的实际花费：

功能	服务商	每月典型费用
TTS 解说（轻度使用）	Google Cloud TTS (WaveNet)	$0.00（每月 100 万字符免费额度）
TTS 解说（重度使用）	ElevenLabs	约 $5.00（入门计划）
TTS 解说	本地（KittenTTS 或系统 TTS）	$0.00

作为对比，Chess.com Diamond 每月 13-20 美元，DecodeChess 每月 8.25 美元。使用 Google Cloud TTS 免费额度的典型 En Parlant~ 用户完全不需要花一分钱。

面向技术用户

你已经知道这是怎么回事了。以下是快速版：

1. 在你偏好的服务商处创建账号。
2. 生成 API 密钥。
3. 将其粘贴到 En Parlant~ 设置中对应的字段。
4. 完成。

当前 BYOK 服务商：

服务	服务商	获取密钥的位置
TTS	ElevenLabs	Dashboard → Profile → API Keys
TTS	Google Cloud	APIs & Services → Credentials

你的密钥存储在本机应用的 localStorage 中。它们除了通过 HTTPS 在请求头中直接发送给相应的 API 服务商外，不会被传输到任何其他地方。En Parlant~ 没有遥测、没有数据分析、没有服务器端组件。

如果你想完全离线使用，推荐的方案是用 KittenTTS 进行语音解说。它在本地运行，生成的语音自然流畅，远超操作系统自带的语音。无需 API 密钥，无需联网。请参阅 TTS 服务商总览 了解所有选项。

应用内置的成本控制：

• 音频缓存（TTS 不会为已经朗读过的文本重新生成音频）
• 请求取消（当你在响应完成前离开页面时自动取消请求）

面向非技术用户

如果 “API key” 这样的术语不在你的日常词汇中，以下是你需要了解的内容：

概念很简单。 像 ElevenLabs（提供逼真语音解说）这样的云服务提供按量付费的账号——类似于预付费手机套餐。你往账号里充值，每次 En Parlant~ 播报一步棋时，都会消耗极少量费用。En Parlant~ 通过一个类似密码的代码（称为 API 密钥）连接你的账号。

你完全不需要密钥也能使用。 核心国际象棋应用无需任何密钥即可完整运行。使用系统自带语音或 KittenTTS 进行 TTS 解说不需要账号，也不需要联网。云服务商是一种升级选项，而非必需。

大约五分钟就能搞定。 你在服务商网站创建账号，添加支付方式，然后把一串代码复制到 En Parlant~ 的设置中，就完成了。每个服务商都有分步指南引导你完成整个过程。我们在应用的设置页面直接链接了这些指南——你不会一头雾水。

费用很低。 Google Cloud 的文字转语音有慷慨的免费额度，足以覆盖大多数用户的使用且完全免费。即使是 ElevenLabs 的入门计划也只要每月 5 美元，远低于任何国际象棋订阅。

你始终掌握主动权。 你可以随时关闭任何功能。而且由于 En Parlant~ 本身没有订阅，即使你停止使用也没有什么需要取消的。

总结

BYOK 不是权宜之计，也不是功能局限——它是一种深思熟虑的架构选择，JetBrains、GitHub 以及大多数开源 AI 生态系统都在采用。它让软件保持免费，让维护者保持可持续，也让用户直接掌控自己的支出和数据。

对于 En Parlant~ 来说，这意味着我们可以在一款免费开源的国际象棋应用中提供高品质语音解说，用户只需为自己选择使用的云服务付费。或者，如果他们更喜欢免费的本地替代方案，也可以完全不花一分钱。