自带密钥(BYOK)

保存您组织的 Anthropic、OpenAI、Google 和 Mistral AI 密钥,让本地化请求使用您的密钥运行,费用由提供商直接向您收取。

使用您自己的模型提供商 API 密钥进行本地化。在设置的 BYOK 页面添加组织密钥,再选择用于本地化的模型。调用该提供商模型的请求将使用您的密钥,词元费用由提供商直接向您收取。此功能仅限 Enterprise 套餐使用。

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

使用您的密钥进行本地化 #

其他功能(如 AI 评估器和引擎建议)无需提供商密钥,也无需选择模型。

计费 #

使用您的密钥进行本地化时,模型的词元费用由提供商向您收取,Lingo.dev 不再收取模型费用。本地化内容的 Lingo.dev 基础设施费用仍照常收取。不使用您的密钥进行本地化时,模型费用会从您的 Lingo.dev 额度中扣除。

谁可以管理密钥 #

BYOK 页面的使用受以下两项条件控制:

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

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

添加密钥 #

  1. 打开设置 → BYOK。
  2. 点击提供商旁的添加密钥。
  3. 粘贴 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 移除密钥并不等于撤销密钥。在您前往提供商处撤销之前,该密钥仍然有效。