错误码

错误形状

所有错误统一返回：

{
  "error": {
    "code": "API_KEY_INVALID",
    "message": "API Key 无效，请检查配置"
  }
}

code	HTTP	含义与处理
`API_KEY_INVALID`	401	Key 无效、已撤销或格式不对。检查 Key 配置；确认带了 `Authorization: Bearer` 头
`TEAM_API_DISABLED`	4xx	团队关掉了 API 总闸。换 Key 没用，联系团队管理员在「API 密钥」页打开
`API_MODEL_NOT_ALLOWED`	403	模型不在这把 Key 的白名单里。换白名单内的模型，或找管理员放开

code	HTTP	含义与处理
`API_KEY_DAILY_LIMIT_EXCEEDED`	4xx	这把 Key 今日消费到上限。等明天，或找管理员调上限
`API_KEY_MONTHLY_LIMIT_EXCEEDED`	4xx	本月消费到上限
`INSUFFICIENT_BALANCE`	4xx	团队点数不足，去充值

code	HTTP	含义与处理
`REQUEST_PARAM_ERROR`	400	参数不合法，`message` 里有具体原因。常见：漏了 `request_id`、`params`/`refs` 不是合法 JSON、refs 里不是 http(s) 地址
`TASK_NOT_FOUND`	404	任务编号不存在或不属于你的团队
`AI_MODEL_NOT_FOUND`	4xx	模型不存在或已下架，对照左侧模型页检查 `model` 拼写

任务 status = failed 时，失败原因在任务对象的 error_code 里，点数已自动退还：

error_code	含义
`AI_UPSTREAM_FAILED`	上游生成失败。参考图拉不到也会表现为这个
`AI_CONTENT_POLICY_VIOLATION`	内容被安全策略拦截，换提示词

code	HTTP	含义与处理
`SERVER_COMMON_ERROR`	500	服务端开小差。用同一个 `request_id` 重试（幂等，不会重复扣费）；持续出现请联系我们