MiniMax H3
MiniMax H3 查询视频任务
使用 GET /v1/videos/{task_id} 查询 MiniMax H3 视频任务状态、结果与错误信息。
GET
MiniMax H3 查询视频任务
MiniMax H3 任务提交成功后,通过GET /v1/videos/{task_id} 轮询状态。任务完成后优先读取响应中的 video_url,如果没有可访问直链,再使用 GET /v1/videos/{task_id}/content 代理下载 MP4。
- 根据创建任务返回的
id或task_id查询。 - 任务处理中继续轮询,不要重复提交同一个生成请求。
- 任务完成后读取
video_url或回退到/content。 - 任务失败时读取
error,并把原始错误信息写入日志,方便定位上游拒绝、额度不足或素材不可访问。
方法与路径
请求示例
响应示例
认证
Path Parameters
string
required
视频任务 ID。创建视频任务接口返回的
id 或 task_id。Response
string
视频任务 ID。
string
视频任务 ID 的兼容字段。通常与
id 相同。string
对象类型,通常为
video。string
任务实际使用的模型,例如
minimax-h3-768p、minimax-h3-2k、minimax-h3-pro-768p 或 minimax-h3-pro-2k。如果创建任务时传的是前端单入口 minimax-h3,这里可用来确认最终落到普通 768P 还是普通 2K 档。string
任务状态。常见值为
queued、pending、in_progress、processing、completed、failed。integer
任务进度百分比。部分上游不会稳定更新进度,客户端不要只依赖该字段判断是否卡住。
string
任务完成后的视频地址。为空或不可访问时,使用
GET /v1/videos/{task_id}/content 下载。object
任务失败原因。通常包含
message 和 code。状态处理建议
建议轮询间隔保持在数秒以上。长视频、2K 或 Pro 参考视频任务可能需要更长生成时间,只要状态仍是处理中,就继续轮询。
下载视频内容
如果查询结果没有直接返回可访问的video_url,或者直链下载失败,可以请求内容代理端点:
/content 时需要继续携带鉴权头:
注意事项
- 查询接口只读取任务状态,不会重新提交生成任务。
progress长时间不变不一定代表任务失败,应以终态状态为准。- 如果任务失败,建议记录
model、duration、ratio、referenceImages、referenceVideos、referenceAudios和完整error,方便排查参数、素材访问和内容审核问题。