文生视频

POST

/task/minimax/v1/video_generation

提示

请注意参数必填字段，如果缺失必填参数，有可能造成无法识别内部模型名称。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

model

enum<string>

模型名称

必需

枚举值:

MiniMax-Hailuo-2.3MiniMax-Hailuo-02T2V-01-DirectorT2V-01

示例:

MiniMax-Hailuo-2.3

prompt

string

视频描述

必需

视频的文本描述，最大 2000 字符。对于 MiniMax-Hailuo-2.3、MiniMax-Hailuo-02 和 *-Director 系列模型，支持使用 [指令] 语法进行运镜控制。
可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制。
支持 15 种运镜指令的指令:
左右移: [左移], [右移]
左右摇: [左摇], [右摇]
推拉: [推进], [拉远]
升降: [上升], [下降]
上下摇: [上摇], [下摇]
变焦: [变焦推近], [变焦拉远]
其他: [晃动], [跟随], [固定]
使用规则:
组合运镜: 同一组 [] 内的多个指令会同时生效，如 [左摇,上升]，建议组合不超过 3 个
顺序运镜: prompt 中前后出现的指令会依次生效，如 "...[推进], 然后...[拉远]"
自然语言: 也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应
多运镜教程及模板，可参考运镜使用教程
可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制。

duration

enum<integer>

必需

视频时长（秒），默认值为 6。其可用值与模型和分辨率相关：

模型	720p	768p	1080P
MiniMax-Hailuo-2.3	-	6或10	6
MiniMax-Hailuo-02	-	6或10	6
其他模型	6	-	6

枚举值:

610

resolution

string

必需

视频分辨率。其可用值与模型相关：

模型	6s	10s
MiniMax-Hailuo-2.3	768P (默认), 1080P	768P (默认)
MiniMax-Hailuo-02	768P (默认), 1080P	768P (默认)
其他模型	720P (默认)	不支持

prompt_optimizer

boolean

prompt优化

可选

是否自动优化 prompt，默认为 true。设为 false 可进行更精确的控制

默认值:

true

fast_pretreatment

boolean

可选

是否缩短 prompt_optimizer 的优化耗时，默认为 false。仅对 MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-02 模型生效。

默认值:

false

callback_url

string

可选

接收任务状态更新通知的回调 URL。支持通过 callback_url 参数可以配置回调，以接收任务状态的更新的异步通知。

地址验证：配置后，MiniMax 服务器会向 callback_url 发送一个 POST 请求，请求体中包含 challenge 字段。服务端需要在 3 秒内原样返回该 challenge 值以完成验证
状态更新：验证成功后，每当任务状态变更时，MiniMax 都会向该 URL 推送最新的任务状态。推送的数据结构与调用查询视频生成任务接口的响应体一致
回调返回的“status”包括以下状态：

“processing”-生成中
“success”-成功
“failed”-失败

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.pawmaas.com/task/minimax/v1/video_generation' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "女子拿起一本书[上升]，然后阅读[固定]。",
    "duration": 6,
    "resolution": "1080P"
}'

返回响应

🟢200成功

application/json

Body

task_id

string

必需

base_resp

object

必需

status_code

integer

必需

status_msg

string

必需

示例

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

修改于 25 天前

查询：任务结果

图生视频