# 自带 Key，所有供应商，一个 API

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

- Date: June 28, 2026
- Category: product
- HTML: https://anyrouter.dev/blog/zh/bring-your-own-keys

## 用你已经在付的 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 页是粘贴并保存：

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，它的模型自动进池，不用改配置：

```bash
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。
