图生视频生成

方法: POST路径: /minimax/v1/video_generation

可用值：MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

model
string
必需
可用值：MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01
prompt
string
必需
视频的文本描述，最大 2000 字符。对于 MiniMax-Hailuo-02 和 I2V-01-Director 模型，支持使用 [指令] 语法进行运镜控制。
可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制。
支持 15 种运镜指令的指令:
左右移: [左移], [右移]
左右摇: [左摇], [右摇]
推拉: [推进], [拉远]
升降: [上升], [下降]
上下摇: [上摇], [下摇]
变焦: [变焦推近], [变焦拉远]
其他: [晃动], [跟随], [固定]
使用规则:
组合运镜: 同一组 [] 内的多个指令会同时生效，如 [左摇,上升]，建议组合不超过 3 个。
顺序运镜: prompt 中前后出现的指令会依次生效，如 "...[推进], 然后...[拉远]"。
自然语言: 也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应。
duration
integer
可选
first_frame_image
string
必需
将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)。
resolution
enum<string>
可选
枚举值:
768P
1080P
prompt_optimizer
boolean
可选
是否自动优化 prompt，默认为 true。设为 false 可进行更精确的控制
示例
{
"model"
:
"string"
,
"prompt"
:
"string"
,
"duration"
:
0
,
"first_frame_image"
:
"string"
,
"resolution"
:
"768P"
,
"prompt_optimizer "
:
true
}

请求示例代码

Shell

curl --location --request POST '/minimax/v1/video_generation' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "prompt": "string",
    "duration": 0,
    "first_frame_image": "string",
    "resolution": "768P",
    "prompt_optimizer ": true
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

id
string
必需

示例

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