创建视频生成任务

开发环境

https://draw.openai-next.com

POST

/minimax/v1/video_generation

发起一个异步的视频生成任务，支持文生视频（T2V）、图生视频（I2V）和主体参考视频（S2V）等多种模式。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

model

enum<string>

必需

调用的算法模型ID。

枚举值:

MiniMax-Hailuo-02T2V-01-DirectorI2V-01-DirectorS2V-01I2V-01-liveI2V-01T2V-01

prompt

string

可选

生成视频的文字描述，最大支持2000字符。
运镜控制 (Camera Control):
当model为MiniMax-Hailuo-02、T2V-01-Director或I2V-01-Director时，支持更精准的运镜控制。

指令格式: [C1,C2,C3]，建议组合不超过3个。

15种运镜指令:

左右移: [左移], [右移]

左右摇: [左摇], [右摇]

推拉: [推进], [拉远]

升降: [上升], [下降]

上下摇: [上摇], [下摇]

变焦: [变焦推近], [变焦拉远]

晃动: [晃动]

跟随: [跟随]

固定: [固定]

组合与顺序: [左摇,右移]表示同时生效；...[左摇]...[右移]表示先后生效。

自然语言: 也支持通过自然语言描述运镜，与指令同时生效。

示例值:

一个男人拿起一本书[上升]，然后静静地阅读[固定]。

prompt_optimizer

boolean

可选

是否自动优化prompt。默认为true。若需精确控制，可设为false，此时建议提供更精细的prompt。

默认值:

true

duration

enum<integer>

可选

生成视频时长（秒）。

01系列模型: 仅支持 6 秒。

MiniMax-Hailuo-02 (02系列):

768P: 支持 6 (默认), 10 秒。

1080P: 仅支持 6 秒。

枚举值:

610

默认值:

resolution

enum<string>

可选

生成视频的分辨率。

01系列模型: 不支持设置，默认为 720P。

MiniMax-Hailuo-02 (02系列):

6s时长: 支持 768P (默认), 1080P。

10s时长: 仅支持 768P。

枚举值:

768P1080P

默认值:

768P

first_frame_image

string <uri>

可选

视频首帧图片。支持公网URL或Base64字符串 (data:image/jpeg;base64,{data})。

必填模型: I2V-01, I2V-01-Director, I2V-01-live。

可选模型: MiniMax-Hailuo-02。
图片要求:

格式: JPG/JPEG/PNG/WebP

长宽比: 2:5 到 5:2 之间

短边像素 > 300px

体积 < 20MB

subject_reference

array[string]

可选

主体参考，仅当 model 为 S2V-01 时可用。目前仅支持单主体参考（数组长度为1）。

<= 1 items

callback_url

string <uri>

可选

回调URL。配置后，任务状态更新时会向此地址发送POST请求。首次配置需处理challenge校验请求。

示例

{
    "model": "MiniMax-Hailuo-02",
    "prompt": "男子拿起一本书[上升]，然后阅读[固定]。",
    "duration": 6
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://draw.openai-next.com/minimax/v1/video_generation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "男子拿起一本书[上升]，然后阅读[固定]。",
    "duration": 6
}'

返回响应

🟢200成功

application/json

任务创建成功，返回异步任务ID。

Body

task_id

string

可选

视频生成异步任务的ID，用于后续查询任务状态。

base_resp

object (BaseResp)

可选

基础响应体，包含请求的状态码和信息。

status_code

integer

可选

状态码:

0: 请求成功

1002: 触发限流

1004: 账号鉴权失败

1026: 输入内容涉及敏感内容

1027: 生成视频涉及敏感内容

status_msg

string

可选

状态消息，success 表示成功。

示例

{
    "task_id": "106916112212032",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

修改于 2025-07-24 09:24:51

批量获取任务(免费)

查询视频生成任务状态