接口参考

错误与限流

识别错误，理解配额与重试行为。

错误格式

{
  "error": {
    "message": "无效或已撤销的 API 密钥。",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

状态	说明
`400`	JSON 或参数不正确；未知字段、非文本 content、超出正文限制
`401`	未登录控制台，或模型 API 密钥无效、已撤销
`404`	模型不存在 / 资源不属于当前工作空间
`429`	密钥或工作空间限流；也可能来自上游供应商
`499`	日志状态：客户端中途取消
`502`	上游连接、响应或流式协议错误
`503`	供应商尚未完成启用配置
`504`	上游响应超时

密钥按固定分钟窗口与 UTC 自然日限流。工作空间总上限为每分钟 180 次、每天 100000 次；在线调试单独限制为每分钟 30 次、每天 500 次。请求计数包含被限流的尝试，不是成功次数。

429 建议等待下一分钟，若已到每日额度则等待 UTC 零点。不自动重试生成请求，避免额外上游费用。并非所有鉴权、参数和限流错误都会写入调用明细。