Skip to content
ProductJune 28, 2026

自带 Key——所有供应商,一个 API

把你已经在付的供应商 key 和订阅接进来,经一个 OpenAI 兼容 URL 自动失败切换,并且——很快——把闲置配额捐进共享池还能拿回额度。

用你已经在付的 key

Bring Your Own Key(BYOK)让你把上游供应商 key——OpenAI、Anthropic、Google 以及几十家——挂到 AnyRouter 账号。请求匹配到某把 key 能服务的模型时,AnyRouter 用你的 key 转发。你保留所有 AnyRouter 能力——统一 API、日志、分析、预设、路由、应用归因——并按供应商标价直接付给他们。

如果你已经有带额度、议价、预览权限或包月编程订阅的供应商账号,BYOK 是把它们全部放到一个兼容 OpenAI 和 Anthropic 的端点后面的最简单办法。把现有客户端指到 AnyRouter base URL,保留 model id,由你自己的 key 干活。

你能得到什么

BYOK 把一堆分开的供应商账号变成一个有韧性的端点:

  • 自己的 key 不加价。AnyRouter 对 BYOK 流量不收费——没有按请求费、没有附加费、没有最低消费。你只付给供应商。
  • 保留自己的速率限制。走的是你账号的配额,不是共享池——限制就是供应商给你的那些。
  • 自动失败切换。同一供应商加多把 key,AnyRouter 在它们之间分流量,401 或 429 的 key 隔离,切到下一把——一把烧掉的 key 不再是单点故障。
  • 负载均衡策略。每个供应商的 key 池可选 Fallback(优先级)、Round Robin、Weighted 或 Random。
  • 回退到额度。某供应商所有 BYOK key 都耗尽时,请求可以落到按量额度——活继续流。

能接的供应商

AnyRouter 为 60 多家供应商开放 BYOK。常见几家,以及各自期望的 key 格式:

供应商Key 格式说明
OpenAIsk-…可选 org/project header,经 Base URL 字段
Anthropicsk-ant-…Claude 模型
Google AI Studio (Gemini)AIzaSy…Gemini Flash 和 Pro 有免费档
Groqgsk_…快速推理
OpenRoutersk-or-…用预设把 AnyRouter 目录模型钉到你的 OpenRouter key
NVIDIA NIMnvapi-…NVIDIA API catalog
Z.aiAPI key标准或 GLM Coding Plan 端点
Ollama CloudAPI key托管开源模型

Azure OpenAI、Amazon Bedrock、Vertex AI 这类企业端点接受结构化凭证——选供应商时对话框会显示期望格式。按供应商的完整配置指南(含去哪生成 key)在 /docs/features/byok-providers。

不到一分钟加一把 key

在 BYOK 页是粘贴并保存:

  1. 打开 /byok(或控制台 → BYOK),在目标供应商上点 Add key。
  2. 粘贴供应商 API key。该值只写不读——保存后 AnyRouter 再也不会显示。
  3. 可选别名、负载均衡优先级和权重,或限定到特定 AnyRouter key。
  4. 点 Save。AnyRouter 对供应商做一次实况校验;被拒则报错且不入库。

在整个池上路由

加了一把或多把 key 之后,三个内置 model id 会在它们全部之间路由,不用点名某个模型——AnyRouter 挑当时最强的可用模型,某家忙了就回退:

Model id路由到
anyrouter/byok你配置的 key 能打到的每个模型
anyrouter/coding擅长编程的子集
anyrouter/agent工具 / function-calling 子集,为 agent 准备

用在任何普通 model id 能用的地方。给新供应商加一把 key,它的模型自动进池——不用改配置:

curl https://anyrouter.dev/api/v1/chat/completions \
-H "Authorization: Bearer $ANYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "anyrouter/coding",
  "messages": [{ "role": "user", "content": "Refactor this function" }]
}'

这些永远只用你自己的 key,从不花 AnyRouter 额度。没有匹配 key 时会得到明确错误让你加 key——绝不会悄悄扣付费容量。

捐闲置 key,拿回额度

多数供应商配额大部分时间闲着。donate-to-pool 让闲置容量干活:在符合条件的 BYOK key 上拨一下开关,AnyRouter 每经它打一笔请求,就把该请求 token 成本最多 8% 记入可领取的待领取余额。

  • 最多拿回 8%。经捐赠 key 服务的每个 token,把名义成本最多 8% 加到待领取余额——Go 5%,Pro/Max 8%,每把 key 每个 UTC 日上限 $1。
  • 能不能捐看的是路由,不是 ToS。开关出现只表示 AnyRouter 有地方把该供应商流量打出去——不是声称其服务条款允许你分享 key。ToS 你自己确认。
  • 明确同意。捐赠需要一次性、有记录的确认:你的 key 可能服务别人的请求——不会自动发生。
  • 立刻退出。控制台关掉,key 马上离池,没有挂起的请求。

池子今天在所有符合条件的供应商上已上线——加一把 key、拨开关开始捐,或看 /pool 的细节。

为保护你的 key 而建

BYOK key 是敏感凭证,AnyRouter 按这个标准对待:

  • 静态加密,每行一把盐——一把 key 的密文泄露不会削弱其他。
  • 界面只写——保存后只显示别名和掩码标识;完整值取不回来。
  • 从不记日志——请求和响应日志剥掉供应商 key,只留别名和供应商,好分辨哪张凭证服务了请求。
  • 保存时实况校验,然后丢掉校验响应。
  • 不与第三方共享——key 只发往它所属的上游供应商。

开始用

打开 /byok 接第一把供应商 key,再把任何兼容 OpenAI 或 Anthropic 的客户端指到 https://anyrouter.dev/api/v1,用自己的账号路由、不加额外费用。

完整功能说明见 /docs/features/byok。从各家生成 key 的逐步说明见 /docs/features/byok-providers。

两分钟发第一笔请求

用自己的 key 免费开始,或充值按 token 计费。Go 每月 $4 额度 — $2/月,或捐一把 provider key 免费开通。

开始使用