图生首尾帧视频

POST

/task/minimax/v1/video_generation

提示

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

model

string

模型名称

必需

模型名称。可用值：MiniMax-Hailuo-02，注意：首尾帧生成功能不支持 512P 分辨率。

prompt

string

视频描述

可选

视频的文本描述，最大 2000 字符。对于 MiniMax-Hailuo-02 和 I2V-01-Director 模型，支持使用 [指令] 语法进行运镜控制。
可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制。

支持 15 种运镜指令的指令:

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

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

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

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

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

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

其他: [晃动], [跟随], [固定]
使用规则:

组合运镜: 同一组 [] 内的多个指令会同时生效，如 [左摇,上升]，建议组合不超过 3 个。

顺序运镜: prompt 中前后出现的指令会依次生效，如 "...[推进], 然后...[拉远]"。

自然语言: 也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应。
多运镜教程及模板，可参考运镜使用教程。

duration

enum<integer>

必需

视频时长（秒）,其可用值与模型和分辨率相关：

模型	768P	1080P
MiniMax-Hailuo-02	6或10	6

枚举值:

610

resolution

string

必需

视频分辨率：注意 P为大写！

其可用值与模型相关：

模型	6s	10s
MiniMax-Hailuo-02	768P (默认), 1080P	768P

first_frame_image

string

必需

将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)。

图片要求：

格式：JPG, JPEG, PNG, WebP

体积：小于 20MB

尺寸：短边像素大于 300px，长宽比在 2:5 和 5:2 之间
⚠️ 生成视频尺寸遵循首帧图片

last_frame_image

string

必需

将指定图片作为视频的结束帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)。

图片要求：
格式：JPG, JPEG, PNG, WebP
体积：小于 20MB
尺寸：短边像素大于 300px，长宽比在 2:5 和 5:2 之间
⚠️ 生成视频尺寸遵循首帧图片，当首帧和尾帧的图片尺寸不一致时，模型将参考首帧对尾帧图片进行裁剪

prompt_optimizer

boolean

prompt优化

可选

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

默认值:

true

fast_pretreatment

boolean

可选

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

默认值:

false

callback_url

string

可选

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

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

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

示例

{
    "prompt": "一个小女孩从小成长到大的变化",
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
    "model": "MiniMax-Hailuo-02",
    "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 '{
    "prompt": "一个小女孩从小成长到大的变化",
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
    "model": "MiniMax-Hailuo-02",
    "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 天前

图生视频

主体参考生视频