MiniMax H3 · MiniMax 格式

查询视频生成任务

用任务 ID 查询任务的状态，任务成功后返回视频地址。请求方式和返回结果与 MiniMax「查询视频生成任务」（视频生成 V2）接口一致。

GEThttps://your-domain/minimax/v2/query/video_generation/{task_id}

请求示例

curl https://your-domain/minimax/v2/query/video_generation/video_8f3k2m9x4q1w7e5r0t6y2u4p \
  -H "Authorization: Bearer $MINIMAX_API_KEY"

返回结果

{
  "task": {
    "id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1791691200,
    "updated_at": 1791691352,
    "content": {
      "url": "https://your-domain/uploads/videos/2026/10/k3Zq8mVt2LxR9pWa.mp4"
    },
    "resolution": "768P",
    "duration": 6,
    "usage": {
      "input_image_count": 0,
      "input_seconds": 0,
      "output_seconds": 6,
      "total_seconds": 6
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

请求参数

路径参数

task_idstring必填

任务 ID，即创建视频生成任务返回的 task_id。只能查询自己账号下 MiniMax 模型的任务，用 OpenAI 格式或在控制台创建的也可以查询。

返回参数

taskobject

任务信息。

task 的字段

idstring

任务 ID。

modelstring

模型 ID，和创建任务时传入的 model 相同。

statusstring

任务状态：queued、running、succeeded、failed 或 cancelled，见任务状态。

errorobject

任务失败（status 为 failed）时返回，其他状态不返回。

子字段

codestring

MiniMax 的错误码，见失败原因。

messagestring

错误信息。

created_atinteger

任务创建时间，Unix 时间戳（秒）。

updated_atinteger

任务状态最后一次更新的时间，Unix 时间戳（秒）。

contentobject

任务成功时返回。

子字段

urlstring

视频地址，mp4 格式。视频生成后会转存到本平台，可以长期访问。

转存失败时返回 MiniMax 的原始地址，这种地址可能会过期，建议拿到视频后及时下载到自己的存储。

resolutionstring

视频分辨率，大写，例如 768P、2K。

durationinteger

视频时长，单位秒。

usageobject

用量，任务成功时返回，其他状态是空对象 {}。按 token 计费的模型会多返回 token 数，例如：

{
  "usage": {
    "completion_tokens": 130500,
    "input_image_count": 0,
    "input_seconds": 0,
    "output_seconds": 6,
    "prompt_tokens": 0,
    "total_seconds": 6,
    "total_tokens": 130500
  }
}

子字段

output_secondsinteger

生成的视频时长，单位秒。

input_secondsinteger

参考视频的总时长，单位秒，不足 1 秒的部分不计。没有参考视频时为 0。

total_secondsinteger

output_seconds 与 input_seconds 之和。

input_image_countinteger

输入的图片数，包括首帧、尾帧和参考图。

total_tokensinteger

只有按 token 计费的模型返回：实际计费的 token 数，见按 token 计费。

completion_tokensinteger

只有按 token 计费的模型返回：其中生成视频的部分。

prompt_tokensinteger

只有按 token 计费的模型返回：其中参考视频的部分，没有参考视频时为 0。

ratiostring

视频宽高比。任务成功后是视频实际的宽高比；画幅跟随图片或素材的任务在完成前返回 adaptive。

task_typestring

任务类型，固定为 generation（视频生成）。

modalitystring

输出类型，固定为 video。

任务状态

status	说明
`queued`	排队中
`running`	生成中
`succeeded`	生成成功，content.url 是视频地址，同时完成扣费
`failed`	生成失败或超过 12 小时没有完成，error 是失败原因，冻结的费用全部退回
`cancelled`	排队中的任务被取消，冻结的费用全部退回

succeeded、failed、cancelled 是最终状态，之后不会再变化。生成时间与模型、分辨率和时长有关，通常需要几分钟，建议每 10 秒以上查询一次。不想轮询的话，可以在创建任务时传 callback_url，见回调通知。

失败原因

任务失败时，error.code 是 MiniMax 的错误码，error.message 说明具体原因。常见的错误码：

error.code	说明
`1026`	提示词或素材未通过审核，请修改后重新提交
`1027`	生成的视频未通过审核，可以调整提示词后重新提交
`2013`	请求的参数或素材不被模型接受
`1000`	生成过程出错或超时，可以稍后重新提交

失败的任务不扣费。