MiniMax 任务查询

MiniMax 任务提交后，按任务 ID 查询生成或再生成任务状态与结果。

GET /v1/videos/{task_id}

将路径中的 {task_id} 替换为 视频生成 返回的任务 ID。任务成功（status=completed）后，产物地址在 video_url 字段。

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：

请求参数

名称	类型	必填	说明
	string	是	路径参数，与生成接口返回的 id 一致

状态流转

status	含义	progress
	排队中	10
	生成中	50
	成功	100
	失败或已取消	100

建议轮询间隔 5–10 秒。上游仅保留最近 7 天的任务记录，超出窗口的任务 ID 将查询失败；视频下载链接有时效，请及时下载或转存。

请求示例

curl https://octopusx.ai/v1/videos/task_a1bxxxxxe5f6 \
  -H "Authorization: Bearer <token>"

响应示例

已完成

{
  "id": "task_a1bxxxxxe5f6",
  "task_id": "task_a1bxxxxxe5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "completed",
  "progress": 100,
  "created_at": 1785125529,
  "video_url": "https://example.com/video.mp4"
}

失败

{
  "id": "task_a1bxxxxxe5f6",
  "task_id": "task_a1bxxxxxe5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "failed",
  "progress": 100,
  "created_at": 1785125529,
  "error": {
    "message": "request failed",
    "code": "upstream_error"
  }
}

响应字段

名称	类型	说明
	string	任务 ID
	string	任务 ID 兼容旧接口（待废弃，值同 ）
	string	固定为
	string	任务使用的模型名称
	string	状态见上表
	integer	进度百分比
	string	任务成功后的产物地址
	object	失败原因（含 / ）

相关接口

• 视频系列概览
• MiniMax 视频生成
• 错误码查询