Skip to main content
BYOK 目前处于开发阶段。请联系 support@arouter.ai 申请加入内测。
自带密钥(BYOK)允许您在 ARouter 中注册您自己的服务商 API 密钥。当请求路由到您已注册密钥的服务商时,ARouter 会使用您的密钥而非其共享密钥池。 优势:
  • 零加价 — 直接以服务商标价付费,无 token 成本加价
  • 您自己的配额 — 请求占用您自己的服务商频率限制,而非 ARouter 的共享池
  • 您自己的数据政策 — 您与服务商之间现有的协议和数据条款适用
  • 统一网关 — 仍可在上层享受 ARouter 的路由、故障切换和可观测性

BYOK 工作原理

  1. 您在 ARouter 控制台中注册服务商 API 密钥
  2. 当 ARouter 将请求路由到该服务商时,它会替换为您的密钥
  3. 您的账户不收取 token 成本(仅收取 ARouter 服务费,如适用)
  4. 响应中返回 usage.is_byok: true

注册密钥

ARouter 控制台 中添加服务商密钥。 支持的服务商及其密钥格式:

BYOK 与服务商排序结合

将 BYOK 与 provider.order 结合使用来控制何时使用您的密钥:
OpenAI 在排序列表中且您已注册 OpenAI BYOK 密钥时,ARouter 会自动为该服务商使用您的密钥。

部分 BYOK

您可以为部分服务商注册密钥,同时对其他服务商使用 ARouter 的共享池:
如果您有 Anthropic BYOK 密钥,将首先使用您的密钥尝试 Anthropic。如果您有 AWS Bedrock 密钥,接下来尝试它。否则 ARouter 回退到其共享池。

Azure OpenAI

注册您的 Azure OpenAI 端点和密钥:
然后路由到它:

AWS Bedrock

两种认证选项: 选项 1:Bedrock API 密钥(推荐)
选项 2:AWS 凭证

Google Vertex AI


识别 BYOK 请求

当使用了您的密钥时,响应的 usage 对象中包含 is_byok: true
is_byok: true 时,usage.cost 反映您的直接服务商成本(非 ARouter 加价)。

密钥优先级与回退


调试 BYOK 问题

在控制台的活动页面中查看每个请求使用了哪个密钥。常见错误: