错误码

所有错误统一格式，code 稳定，message 可读。

错误响应格式

{
  "error": {
    "code": 40002,
    "message": "请提供 prompt 或 lyrics",
    "detail": "可选的补充信息"
  }
}

错误码表

生成失败的错误

任务级失败不返回 HTTP 错误码，而是把失败原因放在查询响应的 data.error 里：

{
  "data": {
    "task_id": "...",
    "status": "FAILED",
    "error": "MiniMax 账户余额不足，请管理员充值后重试",
    "cost": { "credits": 0 }
  }
}

排查顺序

1. 先看 HTTP 状态码：4xx 是你的问题，5xx 是服务端或上游问题。
2. 再看 error.code，它指向具体原因。
3. 最后读 error.detail 或 data.error，那里有完整的人话说明。