API Key 进阶设置

这一页是跑通之后的加料项。如果你还没成功发出第一条请求，先去创建 API Key，这里的每一项都会让排查变复杂。

多分组路由：让请求自动回落

一个 Key 可以绑多个分组。请求按优先级依次尝试，前一个分组不可用就自动落到下一个，不用你手动改配置。

优先级数字越小越先试。常见的三级配置是：

1. 低成本共享分组
2. 主力共享分组
3. 兜底分组

有私有账号的话，也可以把私有分组排在第一位，优先消耗自己的账号。约 30 秒后系统会重新尝试高优先级分组。

认证写法

OpenAI / Anthropic 兼容端点走请求头：

Authorization: Bearer sk-你的密钥

Gemini 原生端点也接受 query 参数，方便某些 SDK：

GET /v1beta/models?key=sk-你的密钥

能用请求头就用请求头——query 参数会进日志和浏览器历史。

IP 限制

给 Key 配 IP 白名单或黑名单，可以限制它只能从固定出口 IP 使用。

只有出口 IP 真的固定时才开。换代理、换 CDN、换服务器、家宽重播号都会改变出口 IP，届时所有请求都会变成 403。开启后先发一条低成本请求验证再投入使用。

有效期

Key 可以设过期时间。到期后请求直接 403，不会有提前提醒，所以给长期跑的客户端配 Key 时留意这一项。

第一次接入时把 IP 限制和有效期都留空，跑通了再逐项加。

出错了看状态码说明，客户端怎么填看配置客户端。