错误码与开发者 QA

建议所有 API 错误保持稳定结构，至少包含 code、message、request_id 和可选 details，方便开发者定位问题并联系客服。

{
  "code": "invalid_request",
  "message": "model is required",
  "request_id": "req_demo_123",
  "details": {}
}

1. 1401 未认证检查 API Key 是否存在、是否过期、是否用于正确环境。
2. 2429 限流降低并发，或使用后台任务队列做重试和退避。
3. 3任务失败读取 task error 字段，区分参数错误、模型拒绝、资源下载失败和系统异常。