查询单个任务

GET

/v1/videos/{task_id}

通过 task_id 查询单个视频生成、H3-Context-IR 或视频再生成任务的状态和结果。任务成功（status=succeeded）后，视频输出位于 content.url，增强提示词位于 content.prompt。

只能查询最近 7 天内的任务，时间窗口为 [T-7d, T)，其中 T 为请求时的 UTC 秒级时间戳。超出窗口的 task_id 会返回 invalid task_id。视频输出 URL 有时效，请及时下载或保存。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

成功返回任务状态和结果。

Bodyapplication/json

示例

FailureH3-Context-IR succeededVideo generation succeededVideo regeneration succeeded

{
    "task": {
        "created_at": 1785125529,
        "duration": 5,
        "error": {
            "code": "1026",
            "message": "video description contains sensitive content"
        },
        "id": "424010985738630",
        "modality": "video",
        "model": "MiniMax-H3",
        "ratio": "16:9",
        "resolution": "2K",
        "status": "failed",
        "task_type": "generation",
        "updated_at": 1785125700,
        "usage": {}
    }
}

🟠400Err400

🟠401Err401

🟠429Err429

🔴500Err500

修改于 2026-08-26 10:48:04

创建视频生成任务

创建视频生成任务 Copy