自带密钥 (BYOK)
企业版方案的自带密钥 (BYOK) 功能：连接 Google Gemini API 密钥即可解锁额外额度、更广泛的模型选择以及直接计费服务。
概述
“自带密钥”(BYOK) 是一项仅限企业版的功能，允许您的组织将 Google Gemini API 密钥直接接入 i1n。这样，AI 翻译任务将通过您自己的 Google AI 账户运行，而不是使用 i1n 的共享推理池。
当启用 BYOK 时，您的企业合同将在协商的限额基础上，额外获得 50% 的 AI 翻译额度和翻译密钥奖励。Google 收取的推理成本将直接计入您的 Google 账户；i1n 将继续负责编排、缓存、变量保护以及品牌语调的执行。
BYOK 可通过仪表板按组织进行配置。密钥在静态存储时会进行加密，且仅用于代表您进行翻译调用——它绝不会被记录、导出或在不同组织间共享。
为何使用 BYOK
在以下任何情况适用时，建议启用 BYOK：您的组织已签署 Google Cloud 或 Google AI Studio 协议；您需要直接查看底层推理的成本；或者您希望在 Google 发布最新 Gemini 预览版模型时第一时间获得优先访问权限。
积分和密钥的 +50% 奖励意味着启用了 BYOK 的企业租户实际上只需支付编排费用，而推理成本则通过您现有的 Google 结算关系进行结算——这通常会在高翻译量下降低总拥有成本。
BYOK 还为您提供了更严格的治理能力。您可以轮换密钥、在 Google AI Studio 中设置配额，并与您的其他 AI 工作负载一起，通过统一的 Google 计费仪表板审计使用情况。
可用模型
启用 BYOK 后，您可以选择用于 AI 翻译的默认 Gemini 模型。您可以随时在仪表板中更改该模型，更改将应用于后续的翻译任务。
Gemini 2.5 Flash-Lite 是推荐的默认模型。对于大多数本地化工作负载而言，它在翻译质量、延迟和成本之间提供了最佳平衡。
Gemini 3 Flash (预览版) 适用于在保持低延迟的同时需要更高质量的通用翻译。Gemini 3.1 Pro (预览版) 提供目前最高的可用质量，建议用于细微差别较多或高风险的内容。Gemini 3.1 Flash-Lite (预览版) 是速度最快的选项，非常适合对吞吐量要求极高的大规模批量处理任务。
预览版模型可能会由 Google 进行更改。i1n 会跟踪新的 Gemini 版本，并在其可用时立即在仪表板中显示 — 切换模型无需修改合同。
设置
第 1 步 — 生成 Gemini API 密钥。登录 Google AI Studio (aistudio.google.com)，打开 API 密钥页面，并创建一个绑定到您希望用于结算的项目的密钥。
第 2 步 — 将密钥添加到 i1n。从仪表板打开您的组织设置，导航至 BYOK 部分，粘贴 API 密钥并保存。密钥在提交后会立即进行静态加密。
第 3 步 — 选择您的默认模型。请从可用的 Gemini 模型中选择一个（请参阅上方的“可用模型”）。此选择将对后续所有通过 CLI、MCP 服务器和仪表板进行的翻译任务生效。
第 4 步 — 验证。针对一小部分键运行 i1n push --translate，并确认任务已完成。仪表板的使用情况视图会显示每项翻译是通过 BYOK 还是默认的 i1n 推理路径处理的。
您可以随时在仪表板中更换密钥以进行轮换——正在运行的任务将继续使用旧密钥直至完成。若要完全禁用 BYOK，请从仪表板中移除该密钥；后续翻译将自动恢复为默认的 i1n 推理路径。