Skip to main content
GET

MiniMax H3 查询视频任务

MiniMax H3 任务提交成功后,通过 GET /v1/videos/{task_id} 轮询状态。任务完成后优先读取响应中的 video_url,如果没有可访问直链,再使用 GET /v1/videos/{task_id}/content 代理下载 MP4。
  • 根据创建任务返回的 idtask_id 查询。
  • 任务处理中继续轮询,不要重复提交同一个生成请求。
  • 任务完成后读取 video_url 或回退到 /content
  • 任务失败时读取 error,并把原始错误信息写入日志,方便定位上游拒绝、额度不足或素材不可访问。

方法与路径

请求示例

响应示例

认证

Path Parameters

string
required
视频任务 ID。创建视频任务接口返回的 idtask_id

Response

string
视频任务 ID。
string
视频任务 ID 的兼容字段。通常与 id 相同。
string
对象类型,通常为 video
string
任务实际使用的模型,例如 minimax-h3-768pminimax-h3-2kminimax-h3-pro-768pminimax-h3-pro-2k。如果创建任务时传的是前端单入口 minimax-h3,这里可用来确认最终落到普通 768P 还是普通 2K 档。
string
任务状态。常见值为 queuedpendingin_progressprocessingcompletedfailed
integer
任务进度百分比。部分上游不会稳定更新进度,客户端不要只依赖该字段判断是否卡住。
string
任务完成后的视频地址。为空或不可访问时,使用 GET /v1/videos/{task_id}/content 下载。
object
任务失败原因。通常包含 messagecode

状态处理建议

建议轮询间隔保持在数秒以上。长视频、2K 或 Pro 参考视频任务可能需要更长生成时间,只要状态仍是处理中,就继续轮询。

下载视频内容

如果查询结果没有直接返回可访问的 video_url,或者直链下载失败,可以请求内容代理端点:
下载 /content 时需要继续携带鉴权头:

注意事项

  • 查询接口只读取任务状态,不会重新提交生成任务。
  • progress 长时间不变不一定代表任务失败,应以终态状态为准。
  • 如果任务失败,建议记录 modeldurationratioreferenceImagesreferenceVideosreferenceAudios 和完整 error,方便排查参数、素材访问和内容审核问题。

相关页面