API 密钥
密钥在门户创建,按 Authorization: Bearer mr-… 携带;一个 key 属于一个账户,账户的余额与限流窗口对名下所有 key 生效。
创建
- 显示名:备注用途,用量明细按显示名展示
- 过期时间:到期后该 key 返回 401,与吊销同一句报错
- 授权模型:为空表示不限模型;非空时,列表外的模型请求返回
alias_not_granted(403)
失败形态
| 参数 | 类型 | 约束 | 说明 |
|---|---|---|---|
缺失、格式错、不存在、吊销、过期 |
401 | invalid_api_key | 同一句 message,不区分具体原因,不泄露任何 key 的存在性 |
key 未授权该模型 |
403 | alias_not_granted | key 有效且已通过认证;在门户补充授权或改用已授权的模型 |
账户余额为负 |
403 | insufficient_balance | 请求执行前拦截;充值后原请求直接重发 |
删除一个仍在生效的 key 先吊销再删除。key 的可用模型以 /v1/models 返回的为准;完整错误语义见错误码。