提交视频生成任务

POST

/v1/video/generations

MiniMax 视频生成（异步任务制）。提交后返回 task_id，通过 GET /v1/video/generations/{task_id} 轮询结果。

可用端点（二选一，参数和行为完全相同）：

端点	说明
`POST /v1/video/generations`	MiniMax 专用端点（本文档）
`POST /v1/videos`	通用视频端点（也支持 MiniMax 模型）

支持模型：

MiniMax-Hailuo-02

MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3-Fast

约束：

MiniMax-Hailuo-2.3-Fast 仅图生视频，必须传 metadata.first_frame_image

MiniMax-Hailuo-2.3-Fast 的 size 仅支持 768p、1080p（不支持 720p）

/v1/videos 调用示例（与本端点参数完全相同）：

请求参数

Body 参数application/json必填

示例

MiniMax-Hailuo-02 文生视频MiniMax 文生视频图生视频（Hailuo） ⚠️ metadata 传参图生视频（Hailuo-2.3-Fast） ⚠️ 仅图生视频

{
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cat playing with a ball of yarn"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

MiniMax-Hailuo-02 文生视频MiniMax 文生视频图生视频（Hailuo） ⚠️ metadata 传参图生视频（Hailuo-2.3-Fast） ⚠️ 仅图生视频

curl --location --request POST '/v1/video/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "A cat playing with a ball of yarn"
}'

返回响应

🟢200成功

application/json

任务已提交

Body

示例

{
    "id": "task_abc123",
    "task_id": "task_abc123",
    "object": "video",
    "model": "MiniMax-Hailuo-2.3",
    "status": "",
    "progress": 0,
    "created_at": 1772037755
}

🟠400请求有误

修改于 2026-04-10 09:20:43

创建 Anthropic Messages 响应

查询 MiniMax 视频任务状态