查询视频

使用创建接口返回的任务 ID 查询状态、结果和用量；成功后可从 task.content.url 获取视频地址。

GET/v2/query/video_generation/{task_id}

使用创建接口返回的 Task ID 查询任务。调用方只能查询自己创建的任务。

建议每 3 到 5 秒查询一次，直至状态变为 succeeded、failed 或 cancelled。queued 与 running 状态应继续轮询。

如果 MiniMax 上游返回合法 JSON 错误，接口会保留上游 HTTP 状态码和 JSON 内容。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Path Parameters

task_id*string

创建 MiniMax-H3 视频时返回的 Task ID。

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v2/query/video_generation/426014652088710"

{
  "task": {
    "id": "426014652088710",
    "model": "MODEL_ID",
    "status": "succeeded",
    "content": {
      "url": "https://example.com/result.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "created_at": 1789625341,
    "updated_at": 1789625437,
    "usage": {
      "input_image_count": 2,
      "input_seconds": 5,
      "input_audio_seconds": 6,
      "output_seconds": 5,
      "total_seconds": 10,
      "prompt_tokens": 480,
      "completion_tokens": 130196,
      "total_tokens": 130676
    }
  }
}

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`