认证与令牌
理解令牌模型是安全、稳定使用网关的基础。
如何携带密钥
OpenAI 兼容接口使用 Authorization: Bearer 头：
Authorization: Bearer sk-你的令牌Claude 兼容接口接受 x-api-key 头；Gemini 兼容接口用查询参数 ?key=。三者都指向同一个令牌。
| 协议 | 鉴权方式 |
|---|---|
OpenAI (/v1/*) | Authorization: Bearer sk-... |
Claude (/v1/messages) | x-api-key: sk-... 或 Bearer |
Gemini (/v1beta/*) | 查询参数 ?key=sk-... |
令牌的可配置项
| 字段 | 说明 | 建议 |
|---|---|---|
| 名称 | 用途标识 | 按应用/环境命名，如 prod、staging |
| 额度 | 可消耗上限，或「无限额度」 | 生产令牌设有限额度，防刷爆 |
| 过期时间 | 到期自动失效 | 临时测试令牌设短有效期 |
| 可用模型 | 限制该令牌能调用哪些模型 | 最小权限：只放需要的模型 |
| 分组 | 决定费率与可见范围 | 由管理员划分（如 default、vip） |
| IP 限制 | 仅允许指定来源 IP 使用 | 服务器固定出口时强烈建议开启 |
额度的计量方式
- 按金额：按 token 单价折算为费用扣减，适合统一结算。
- 按次数：按请求次数扣减，适合做调用配额限制。
- 额度用尽后请求返回
insufficient quota类错误，充值或提高额度后恢复。
安全最佳实践
- 一应用一令牌：泄漏时只吊销一个，不影响其它系统。
- 不入代码库：用环境变量
AI_API_KEY注入，不写死在前端。 - 后端代理：浏览器直连会暴露密钥，务必在服务端发起请求。
- 轮换与吊销：怀疑泄漏立即在控制台删除旧令牌并新建。
- 限 IP：服务端出口 IP 固定时，绑定 IP 白名单。
警告
不要把令牌放在会随页面/客户端分发的地方（前端 JS、移动端硬编码、公开仓库）。网关无法区分合法与恶意使用，令牌泄漏等同额度泄漏。
控制台账号安全
控制台登录账号与令牌是两套东西：账号用于登录管理后台，令牌用于程序调用。请为账号设置强密码，并妥善保管。