BYOK

是 Bring Your Own Key 的缩写，用于在 AI Gateway 中接入用户自己的服务商 API 密钥。配置 BYOK 后，AI Gateway 可以在路由策略中使用用户自有密钥调用对应供应商模型。

上图为 BYOK 页面。页面主体展示可配置供应商列表，每一行包含供应商名称、配置状态和更多操作入口。

页面能力

BYOK 页面支持：

• 查看可配置供应商。
• 搜索供应商。
• 查看供应商配置状态。
• 刷新供应商列表。
• 通过供应商右侧更多菜单进入编辑。

配置供应商密钥

操作步骤：

1. 进入

   BYOK

   BYOK
   。
2. 找到目标供应商。
3. 点击供应商右侧的更多菜单。
4. 点击

   编辑

   编辑
   。
5. 在弹窗中填写名称和密钥。
6. 打开或关闭启用状态。
7. 选择测试模型。
8. 点击

   测试

   测试
   验证密钥。
9. 测试成功后点击

   保存

   保存
   。

配置弹窗字段包括：

• 名称

  名称
  ：该 BYOK 配置的自定义名称。

• 密钥

  密钥
  ：服务商 API Key。

• 启用

  启用
  ：控制该 BYOK 配置是否生效。

• 测试模型

  测试模型
  ：用于验证密钥是否可正常调用。

• 测试

  测试
  ：发起测试请求。

• 保存

  保存
  ：保存配置。

与路由策略配合使用

BYOK 配置完成后，需要在

API KEY 管理

中为对应 API Key 配置路由策略，才能控制业务调用是否使用 BYOK。

常见组合：

• 默认路由 + BYOK 已配置

  默认路由 + BYOK 已配置
  ：由平台默认策略决定是否使用相关供应商。

• 指定供应商 + BYOK 已配置

  指定供应商 + BYOK 已配置
  ：优先使用指定供应商，且同供应商下优先使用 BYOK。

• 仅 BYOK

  仅 BYOK
  ：只走用户自有密钥，不使用平台内置能力。

使用建议

• 保存前先使用测试功能验证密钥。
• 确保服务商侧密钥有效、额度充足且具备对应模型权限。
• 不同供应商密钥建议使用清晰名称区分。
• 修改或停用 BYOK 前，确认是否有 API Key 路由依赖该供应商。
• BYOK 密钥属于敏感信息，不应泄露或写入公开文档。