自带密钥 (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 3.5 Flash-Lite 是推荐的默认模型：速度快、性价比高、批量处理时 JSON 输出稳定，且能严格遵循术语规范与品牌语调。它是 Gemini 3.1 Flash-Lite 的官方继任者，后者将于 2027 年 5 月由 Google 正式停用。
Gemini 3.8 Flash 是针对具有大量术语规则或长且细微差别字符串项目的优质选择，但其单位 Token 成本较高。Gemini 2.5 Flash-Lite 依然是最经济稳定的选择，并作为您所选模型故障时的自动备选方案。预览版模型特意未予提供：Google 可在两周通知期后将其停用，这会导致翻译任务中断。
预览版模型可能会由 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 推理路径。