MiniMax/Hailuo-2.3-I2V
图生视频模型
异步提交任务
接口
https://api.modelverse.cn/v1/tasks/submit
输入
运镜控制说明
MiniMax-Hailuo-2.3 系列模型支持运镜指令,可在 input.prompt 中使用以下运镜指令:
支持的运镜指令(共15种)
运镜使用规则
组合运镜:同一组
[]内可添加多个指令(建议不超过3个),同时生效。示例:"prompt": "一只猫在草地上跑[左摇,上升]"顺序运镜:prompt 中前后指令依次生效。示例:
"prompt": "一只猫在草地上跑[推进], 然后[拉远]"自然语言支持:也可通过自然语言描述运镜,但使用标准指令效果更精准
时长与分辨率对应关系
1. 不同模型支持的时长(秒)
2. 不同模型支持的分辨率
请求示例
⚠️ 如果您使用 Windows 系统,建议使用 Postman 或其他 API 调用工具。
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-Hailuo-2.3",
"input": {
"first_frame_image": "https://cdn.ucloud.com/prod/2024-09-18-16/user/multi_chat_file/9c0b5c14-ee88-4a5b-b503-4f626f018639.jpeg",
"prompt": "A mouse runs toward the camera, smiling and blinking. [推进, 跟随]"
},
"parameters": {
"duration": 6,
"resolution": "1080P",
"prompt_optimizer": true,
"fast_pretreatment": false,
"aigc_watermark": false
}
}'输出
响应示例
{
"output": {
"task_id": "106916112212032"
},
"request_id": "request_id"
}查询任务状态
接口
https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>
请求示例
curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'输出
响应示例(成功)
{
"output": {
"task_id": "176843862716480",
"task_status": "Success",
"urls": ["https://xxxxx/xxxx.mp4"],
"submit_time": 1756959000,
"finish_time": 1756959050
},
"usage": {
"duration": 6
},
"request_id": ""
}响应示例(失败)
{
"output": {
"task_id": "task_id",
"task_status": "Failure",
"submit_time": 1756959000,
"finish_time": 1756959019,
"error_message": "error_message"
},
"usage": {
"duration": 6
},
"request_id": ""
}








