自带密钥(BYOK)
保存您组织的 Anthropic、OpenAI、Google 和 Mistral AI 密钥,让本地化请求使用您的密钥运行,费用由提供商直接向您收取。
使用您自己的模型提供商 API 密钥进行本地化。在设置的 BYOK 页面添加组织密钥,再选择用于本地化的模型。调用该提供商模型的请求将使用您的密钥,词元费用由提供商直接向您收取。此功能仅限 Enterprise 套餐使用。
支持的提供商:Anthropic、OpenAI、Google 和 Mistral AI。
使用您的密钥进行本地化 #
其他功能(如 AI 评估器和引擎建议)无需提供商密钥,也无需选择模型。
计费 #
使用您的密钥进行本地化时,模型的词元费用由提供商向您收取,Lingo.dev 不再收取模型费用。本地化内容的 Lingo.dev 基础设施费用仍照常收取。不使用您的密钥进行本地化时,模型费用会从您的 Lingo.dev 额度中扣除。
谁可以管理密钥 #
BYOK 页面的使用受以下两项条件控制:
- 功能使用资格:组织必须已启用 BYOK 功能(需使用 Enterprise 套餐)。无论是否具备使用资格,该页面都会显示在设置中。如果不具备使用资格,页面会显示“您的套餐不支持使用自有提供商密钥”,且无法保存密钥。
- 权限:添加、替换、启用、停用或移除密钥,都要求成员的角色具备管理设置(
org:manage_settings)权限。未启用 RBAC 时,每位成员都是所有者,均拥有此权限。
所有成员都可以查看哪些提供商已配置密钥,以及密钥是否正在使用。组织 API 密钥不能用于更改这些密钥,请改用个人账号登录。
添加密钥 #
- 打开设置 → BYOK。
- 点击提供商旁的添加密钥。
- 粘贴 API 密钥并保存。
保存时,Lingo.dev 会向提供商验证密钥。如果提供商不接受该密钥,密钥就不会保存。请前往您的提供商账号检查密钥,然后重新粘贴。
密钥可见性
密钥保存后,不会再次完整显示。页面仅显示密钥的最后四个字符和更新时间。如需更改,请使用替换并粘贴新密钥。
使用提供商的模型 #
本地化请求调用某个提供商的模型时,会使用您为该提供商配置的密钥。要在引擎的本地化步骤中使用您的密钥,请在引擎的模型配置中选择该提供商的模型。
| 情况 | 结果 |
|---|---|
| 您已配置并启用该模型提供商的密钥,且提供商允许通过该密钥调用此模型 | 请求使用您的密钥运行 |
| 未配置该提供商的密钥 | 使用目录内模型进行本地化时,会消耗您的 Lingo.dev 额度 |
| 密钥已停用 | 使用目录内模型进行本地化时,会消耗您的 Lingo.dev 额度 |
| 模型不在 Lingo.dev 模型目录中,且您未配置该提供商的密钥,或密钥已停用 | 使用该模型进行本地化会失败,因为 Lingo.dev 的密钥无法调用该模型 |
| 提供商拒绝通过您的密钥调用该模型 | 目录内模型会改用您的 Lingo.dev 额度重试;目录外模型则会失败 |
BYOK 标签
只有当提供商支持通过您的密钥调用引擎中所设的确切模型 ID 时,才会使用您的密钥。模型选择器和引擎的模型配置会将您的密钥可调用的模型标记为 BYOK。已保存且标记为非 BYOK 的模型无法通过您的密钥调用,因此使用该模型进行本地化会消耗您的 Lingo.dev 额度。已保存且标记为需要 Mistral AI 密钥的模型不在 Lingo.dev 模型目录中,只能通过您的 Mistral AI 密钥运行,但您尚未配置该密钥或已将其停用。请添加或启用密钥,或选择其他模型。
无论是未配置密钥,还是密钥已停用,都不会影响使用目录内模型进行本地化。
目录外模型 #
模型选择器还会提供您的 Mistral AI 密钥可调用、但未收录在 Lingo.dev 模型目录中的聊天模型,例如 mistralai/zai-glm-5-3。这些模型会标记为 BYOK,并显示为 provider/model;每个模型使用 Mistral AI 为其指定的模型 ID,仅显示一次。以模型别名(例如 mistralai/zai-glm-latest)保存的模型也会使用您的密钥运行。
这些模型只能使用您的密钥运行,因为 Lingo.dev 自身的密钥无法调用它们。目前,只有 Mistral AI 的模型列表会注明哪些模型属于聊天模型,因此其他提供商的密钥不会带来额外的目录外模型。
密钥被拒绝时 #
以下故障会中止本地化请求。请求不会改用您的 Lingo.dev 额度重试,也不会切换到引擎模型配置中的下一个模型。错误信息会指出对应的提供商和需要解决的问题。
| 情况 | 处理方式 |
|---|---|
| 您的密钥触发了提供商的速率限制 | 几分钟后重试,或向提供商申请提高密钥的速率上限 |
| 您的提供商账号额度或配额已耗尽 | 在提供商处充值或提高配额,然后重试 |
| 提供商拒绝了您的密钥,例如密钥已被撤销 | 在设置 → BYOK 中替换密钥,然后重试 |
| Lingo.dev 无法读取已保存的密钥 | 在设置 → BYOK 中重新保存密钥,然后重试 |
这些限制与您自己的账号和使用上限有关,改用 Lingo.dev 额度重试会掩盖问题,让您无法察觉。
停用密钥 #
停用密钥即可停止使用,无需删除。页面会显示已停用,使用该提供商目录内模型进行本地化时,将消耗您的 Lingo.dev 额度,直到您重新启用密钥。密钥停用期间,目录外模型无法运行。
如果您的套餐不再支持使用自有密钥,已保存的密钥会显示为已存储,未使用。使用该提供商目录内模型进行本地化时,会消耗您的 Lingo.dev 额度,目录外模型则无法运行。密钥会一直保留,直到您将其移除。
移除密钥 #
点击移除密钥,即可从 Lingo.dev 中删除该密钥。使用该提供商目录内模型进行本地化时,将恢复使用您的 Lingo.dev 额度,目录外模型则会停止运行。
在提供商处撤销密钥
从 Lingo.dev 移除密钥并不等于撤销密钥。在您前往提供商处撤销之前,该密钥仍然有效。