创建视频生成任务

POST

/v1/videos

根据多模态输入（文本、图片、视频、音频）创建视频生成任务。本接口为异步接口：创建成功后返回 task_id，需要轮询“查询单个任务”接口获取状态；任务成功后从 task.content.url 获取生成视频。

当前支持模型：MiniMax-H3。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

Image-to-video (i2va)Reference-to-video (r2va)Text-to-video (t2va)

{
    "content": [
        {
            "text": "Pull focus to the people in the background and add more steam to the ramen bowl.",
            "type": "text"
        },
        {
            "image_url": {
                "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
            },
            "role": "first_frame",
            "type": "image_url"
        }
    ],
    "duration": 5,
    "model": "MiniMax-H3",
    "ratio": "adaptive",
    "resolution": "768P"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Image-to-video (i2va)Reference-to-video (r2va)Text-to-video (t2va)

curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "content": [
        {
            "text": "Pull focus to the people in the background and add more steam to the ramen bowl.",
            "type": "text"
        },
        {
            "image_url": {
                "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
            },
            "role": "first_frame",
            "type": "image_url"
        }
    ],
    "duration": 5,
    "model": "MiniMax-H3",
    "ratio": "adaptive",
    "resolution": "768P"
}'

返回响应

🟢200

application/json

创建成功后返回 task_id。请使用该 task_id 调用“查询单个任务”接口获取任务状态和最终结果。

任务成功后，生成视频的下载地址位于 task.content.url。

Bodyapplication/json

示例

{
    "id": "task_AZb2MUrsyX9IXiqLFVR233CdcVHJ4M25",
    "task_id": "task_AZb2MUrsyX9IXiqLFVR233CdcVHJ4M25",
    "object": "video",
    "model": "MiniMax-H3",
    "status": "queued",
    "progress": 0,
    "created_at": 1787627643
}

🟠400Err400

🟠401Err401

🟠402Err402

🟠422Err422

🟠429Err429

🔴500Err500

修改于 2026-08-25 03:14:48

查询视频

查询单个任务