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 的可用模型以模型列表为准；完整错误语义见错误码。