MiniMax H3 · MiniMax 格式

错误码

MiniMax 格式的接口出错时，返回 HTTP 4xx 或 5xx 状态码和 MiniMax 的错误格式，错误类型和错误码与 MiniMax 相同，处理 MiniMax 错误的代码可以直接沿用。

错误格式

例如 duration 传了 0：

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "duration 需为正整数秒数 (2013)",
    "http_code": "400"
  },
  "request_id": "5oAolP1vT0aPGNVd"
}

字段	说明
`type`	固定为 `error`
`error.type`	错误类型，见下表
`error.message`	错误信息，末尾的括号里是 MiniMax 的错误码，例如 (2013)
`error.http_code`	HTTP 状态码，字符串
`request_id`	请求 ID，和响应头 `X-Request-ID` 相同，反馈问题时请提供

错误码列表

HTTP 状态码	error.type	错误码	说明
400	`bad_request_error`	`2013`	参数不合法或模型不支持，例如缺少提示词，分辨率、时长、画幅超出模型的范围，素材无法下载或格式不对；模型不存在、不是 MiniMax 的模型，或者 API Key 不能使用这个模型；取消已经开始生成或已经结束的任务
401	`authorized_error`	`1004`	API Key 缺失或无效、请求的 IP 不在 API Key 的白名单里，或者账号已被禁用
401	`authorized_error`	`2049`	API Key 已禁用或已过期
402	`insufficient_balance_error`	`1008`	账户余额不足，充值后重试；或者 API Key 的额度已用完，可以在控制台 → API Keys调高额度
404	`not_found_error`	`2013`	任务不存在、不属于当前账号或者不是 MiniMax 模型的任务，接口路径写错时也返回这个错误
422	`unprocessable_entity_error`	`1026、1027`	提示词或素材未通过审核，见审核错误
429	`rate_limit_error`	`1002`	请求过于频繁，按 Retry-After 响应头给出的秒数等待后重试
529	`overloaded_error`	`1002`	当前排队的任务较多，或者模型暂时没有可用资源，稍后重试
500	`server_error`	`1000`	服务内部错误或模型服务暂时不可用，稍后重试；多次失败时请带上 request_id 联系客服

创建接口返回错误时不会创建任务，也不会扣费。429、529 和 500 可以稍后重试，其他错误需要先按 message 修改请求，原样重试仍会失败。

审核错误

提示词、素材或生成的视频未通过审核时：在提交时被拦截的，创建接口直接返回 HTTP 422，错误码是 1026（输入内容）或 1027（生成内容）；在生成过程中被拦截的，任务以 failed 结束，错误码在任务的 error.code 里，见失败原因。

审核不通过的请求和任务都不扣费。

处理错误

先看 HTTP 状态码区分成功和失败，失败时从返回结果里取出错误类型、错误信息和 request_id：

处理错误

curl https://your-domain/minimax/v2/video_generation \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "清晨的海边，一只金毛犬沿着浪花奔跑，镜头缓慢跟随，阳光穿过薄雾"}],
    "duration": 0
  }'

需要错误码时，取 error.message 末尾括号里的数字。
没有收到返回结果的网络错误（超时、连接失败等）不会有错误码，需要单独处理。