开放平台 API 认证
开放平台 API 请求使用管理密钥（Management Key）以 Bearer 方式认证：
Authorization: Bearer rat_your_management_key示例：
curl https://www.routeapi.ai/api/open/v1/balance \ -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"管理密钥（Management Key）
Section titled “管理密钥（Management Key）”管理密钥是调用开放平台 API（/api/open/v1）的凭证，以 rat_ 开头。它和调用模型用的 sk- API Key 是两种不同的凭证：
| 凭证 | 前缀 | 用途 |
|---|---|---|
| 管理密钥 | rat_ | 调用 /api/open/v1 管理账户与 API Key |
| API Key | sk- | 调用模型接口（如 /v1/chat/completions），见 Chat Completions |
管理密钥只能操作所属用户自己的资源，不继承管理员权限，也不能通过开放平台 API 管理管理密钥本身。
创建管理密钥
Section titled “创建管理密钥”- 登录 RouteAPI 控制台。
- 在侧栏打开 Management Keys（位于 Billing 与 Playground 之间），或直接访问 console/management-keys。
- 填写名称、选择过期时间，创建密钥。
- 立即复制并保存
rat_开头的明文密钥。
每个用户最多保留 10 个管理密钥。过期的密钥会留在列表中并继续占用名额，删除后才能再建。密钥泄露时请在同一页面删除，删除立即生效。
新建的管理密钥只能删除，不能吊销或重新启用。删除是让密钥失效的唯一方式，使用已删除密钥的请求会返回 401 invalid_token。
- 把管理密钥保存在密钥管理服务或 CI secret 中，不要写进提交到仓库的源码或配置文件。
- 为每个脚本或服务单独创建一个管理密钥，这样删除其中一个不会影响其他。
- 设置过期时间。不再需要的密钥应当直接删除，而不是等它自然过期。
- 只把密钥交给真正需要管理账户的系统。调用模型的应用需要的是
sk-API Key，而不是这个。 - 定期检查管理密钥列表，删除任何已经不认识的密钥。
两种凭证不能互换，各自对应的 API 都会用 401 拒绝另一方的密钥：
| 请求 | 结果 |
|---|---|
把 sk- API Key 发到 /api/open/v1 | 401 invalid_token，该路径需要管理密钥 |
把 rat_ 管理密钥发到模型接口（如 /v1/chat/completions） | 401 认证错误，该路径需要 API Key |
如果密钥看起来有效，但请求任一 API 都返回 401，请确认它是在哪个页面创建的、前缀是什么。
错误码与频率限制见 开放平台 API 错误与限制。