使用自有密钥 (BYOK)

在设置中的BYOK页面保存组织自己的模型提供商 API 密钥。此后，针对该提供商模型的本地化请求将使用您的密钥直接发送给提供商，费用由提供商向您收取。此功能需使用 Enterprise 套餐。

支持的提供商：Anthropic、OpenAI、Google 和 Mistral AI。

哪些请求会使用您的密钥#

只有本地化请求使用您的密钥运行，其他所有请求仍使用 Lingo.dev 的密钥。

请求	密钥
本地化：localize API、本地化任务、Playground，以及引擎执行的每个本地化步骤	您的密钥（如果已为该模型的提供商配置密钥）
质量门禁	Lingo.dev 的密钥
AI 评估器	Lingo.dev 的密钥
引擎建议	Lingo.dev 的密钥

使用您的密钥处理请求时，提供商会按消耗的词元向您收费。

使用BYOK页面需满足以下两项条件：

功能使用资格：组织必须已启用 BYOK 功能（需要 Enterprise 套餐）。该页面始终显示在设置中。没有使用资格时，页面会显示“您的套餐不支持使用自有提供商密钥”，且无法保存密钥。
权限：添加、替换、启用、停用和移除密钥，都需要成员的角色拥有管理设置 (org:manage_settings) 权限。未启用 RBAC 时，每位成员都是所有者，均拥有此权限。

所有成员都可以查看哪些提供商已配置密钥，以及密钥是否正在使用。不能通过组织 API 密钥更改这些密钥，请改用个人身份登录。

保存时，Lingo.dev 会向提供商验证密钥。如果提供商不接受该密钥，就不会保存。请前往您的提供商账户检查密钥，然后重新粘贴。

密钥的显示方式

密钥保存后将不再完整显示。页面仅显示密钥的最后四个字符和更新时间。如需更改，请使用替换并粘贴新密钥。

引擎调用该提供商的模型时，会使用您的密钥。要使用您的密钥运行某个提供商的模型，请在引擎的模型配置中选用该模型。

情况	处理方式
已为该模型的提供商配置密钥，且密钥已启用	请求使用您的密钥运行
未配置该提供商的密钥	请求照常使用 Lingo.dev 的密钥运行，并消耗您的积分
密钥已停用	请求使用 Lingo.dev 的密钥运行，并消耗您的积分
提供商拒绝使用您的密钥调用该模型	请求改用 Lingo.dev 的密钥重试，并消耗您的积分

未配置密钥或密钥已停用，都不会中断本地化。但如果提供商在开始响应后才拒绝模型调用，请求可能会失败。为避免这种情况，请为您的密钥开通该模型的访问权限，或选择其他模型。

以下故障会终止请求。请求不会改用 Lingo.dev 的密钥，也不会切换到引擎模型配置中的下一个模型。错误信息会说明涉及的提供商和需要解决的问题。

这些限制来自您自己的账户，因此改用 Lingo.dev 的密钥发送请求，会让您无法察觉这些问题。

停用密钥即可停止使用，无需删除。页面会显示已停用，该提供商的模型将使用 Lingo.dev 的密钥运行，并消耗您的积分，直到您重新启用密钥。

如果您的套餐不再支持使用自有密钥，已保存的密钥会显示为已保存，未使用。该提供商的模型将使用 Lingo.dev 的密钥运行，并消耗您的积分。已保存的密钥会一直保留，直到您将其移除。

点击移除密钥。密钥将从 Lingo.dev 中删除，该提供商的模型会恢复使用 Lingo.dev 的密钥运行，并消耗您的积分。

请在提供商处吊销密钥

从 Lingo.dev 移除密钥并不会将其吊销。在您前往提供商处吊销之前，该密钥仍然有效。