用你已经在付的 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 格式 | 说明 |
|---|---|---|
| OpenAI | sk-… | 可选 org/project header,经 Base URL 字段 |
| Anthropic | sk-ant-… | Claude 模型 |
| Google AI Studio (Gemini) | AIzaSy… | Gemini Flash 和 Pro 有免费档 |
| Groq | gsk_… | 快速推理 |
| OpenRouter | sk-or-… | 用预设把 AnyRouter 目录模型钉到你的 OpenRouter key |
| NVIDIA NIM | nvapi-… | NVIDIA API catalog |
| Z.ai | API key | 标准或 GLM Coding Plan 端点 |
| Ollama Cloud | API key | 托管开源模型 |
Azure OpenAI、Amazon Bedrock、Vertex AI 这类企业端点接受结构化凭证——选供应商时对话框会显示期望格式。按供应商的完整配置指南(含去哪生成 key)在 /docs/features/byok-providers。
不到一分钟加一把 key
在 BYOK 页是粘贴并保存:
- 打开 /byok(或控制台 → BYOK),在目标供应商上点 Add key。
- 粘贴供应商 API key。该值只写不读——保存后 AnyRouter 再也不会显示。
- 可选别名、负载均衡优先级和权重,或限定到特定 AnyRouter key。
- 点 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。
相关文章
BYOK: bring your own keys to every provider
Attach the OpenAI, Anthropic, Google, and 60+ other provider keys you already pay for, route them through one OpenAI-compatible URL at $0 markup, cap spend per key, and — if you donate idle quota to the shared pool — earn up to 8% back and unlock Go for free while a donated key stays active.
Donate an idle provider key, earn credits back: a walkthrough
Hold a provider key with headroom to spare? Donate it to the shared pool in two clicks. Every token the pool serves through your key earns pending credits — up to 8% of its notional cost, tiered by plan — claim them anytime or turn on auto-claim. Here's the step-by-step.
