curl --request POST \
--url https://api.maxapi.ai/hailuo/v1/video_generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-Hailuo-2.3"
}
'{
"task_id": "task_1234567890abcdef",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}{
"base_resp": {
"status_code": 1001,
"status_msg": "Invalid parameter: prompt is required"
}
}{
"base_resp": {
"status_code": 1002,
"status_msg": "Invalid API key"
}
}{
"base_resp": {
"status_code": 5000,
"status_msg": "Internal server error"
}
}海螺视频生成统一接口,支持多种生成模式
注意: 所有视频生成功能(文生视频、图生视频、首尾帧、主体参考)都使用同一个接口,通过不同的参数组合来实现不同功能。
支持的模型:
文生视频 (Text to Video)
- MiniMax-Hailuo-02: 海螺02,支持512P/768P/1080P
- MiniMax-Hailuo-2.3: 海螺2.3,支持768P/1080P
- MiniMax-Hailuo-2.3-Fast: 海螺2.3快速版,支持768P/1080P
- T2V-01-Director: 导演版,支持镜头控制
- T2V-01: 基础版
图生视频 (Image to Video)
- I2V-01-Director: 导演版
- I2V-01-live: 实况版
- I2V-01: 基础版
首尾帧生视频
- 所有 Hailuo 系列模型
主体参考生视频
- S2V-01: 主体参考生视频模型
curl --request POST \
--url https://api.maxapi.ai/hailuo/v1/video_generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-Hailuo-2.3"
}
'{
"task_id": "task_1234567890abcdef",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}{
"base_resp": {
"status_code": 1001,
"status_msg": "Invalid parameter: prompt is required"
}
}{
"base_resp": {
"status_code": 1002,
"status_msg": "Invalid API key"
}
}{
"base_resp": {
"status_code": 5000,
"status_msg": "Internal server error"
}
}授权
使用 MiniMax API Key 进行认证
请求头
请求体
视频生成请求参数。根据不同的模型和参数组合,可实现文生视频、图生视频、首尾帧生视频、主体参考生视频等功能。
模型名称。不同模型支持不同的功能:
- 文生视频: MiniMax-Hailuo-02, MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, T2V-01-Director, T2V-01
- 图生视频: I2V-01-Director, I2V-01-live, I2V-01
- 首尾帧: 所有Hailuo系列
- 主体参考: S2V-01
MiniMax-Hailuo-02, MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, T2V-01-Director, T2V-01, I2V-01-Director, I2V-01-live, I2V-01, S2V-01 "MiniMax-Hailuo-2.3"
视频的文本描述,最大2000字符。对于Hailuo-2.3、Hailuo-02和*-Director系列模型,支持使用[指令]语法进行运镜控制。
支持15种运镜指令:
- 左右移: [左移], [右移]
- 左右摇: [左摇], [右摇]
- 推拉: [推进], [拉远]
- 升降: [上升], [下降]
- 上下摇: [上摇], [下摇]
- 变焦: [变焦推近], [变焦拉远]
- 其他: [晃动], [跟随], [固定]
2000"一只可爱的小猫在阳光下玩耍[推进],然后跳跃[跟随]"
首帧图片URL或base64编码。用于图生视频或首尾帧生视频。
"https://example.com/image.jpg"
尾帧图片URL或base64编码。用于首尾帧生视频,需要同时提供first_frame_image。
"https://example.com/last.jpg"
主体参考图片URL或base64编码。用于主体参考生视频(S2V-01模型)。
"https://example.com/subject.jpg"
视频时长(秒),默认值为6。可用值与模型和分辨率相关:
- MiniMax-Hailuo-2.3: 768P支持6或10秒,1080P仅支持6秒
- MiniMax-Hailuo-02: 768P支持6或10秒,1080P仅支持6秒
- 其他模型: 仅支持6秒
6, 10 6
视频分辨率。可用值与模型相关:
- MiniMax-Hailuo-2.3: 768P(默认), 1080P
- MiniMax-Hailuo-02: 768P(默认), 1080P
- 其他模型: 720P(默认)
720P, 768P, 1080P "1080P"
是否自动优化prompt,默认为true。设为false可进行更精确的控制。
true
是否缩短prompt_optimizer的优化耗时,默认为false。仅对MiniMax-Hailuo-2.3和MiniMax-Hailuo-02模型生效。
false
接收任务状态更新通知的回调URL。配置后,MiniMax会在任务状态变更时推送通知。
"https://your-domain.com/callback"
是否在生成的视频中添加水印,默认为false。
false