Nuwa Video Gen - MiniMax 女娲视频生成#

使用 MiniMax 女娲视频生成 API，支持4种生成模式：

1. 文生视频：根据文本描述生成视频
2. 图生视频：基于图片 + 文本描述生成视频
3. 首尾帧：首图 + 尾图 + 文本描述生成视频
4. 主体参考：人脸照片 + 文本描述，保持人物特征一致

前置要求#

• API Key：从 platform.minimaxi.com 获取
• 安装依赖： pip3 install requests
• 设置环境变量： export MINIMAX_API_KEY="your-key"

使用方法#

Python 脚本（推荐）#

bash

# 文生视频
python3 {baseDir}/scripts/video_gen.py --mode text --prompt "描述文字"

# 图生视频
python3 {baseDir}/scripts/video_gen.py --mode image --prompt "描述文字" --image "图片URL"

# 首尾帧生成
python3 {baseDir}/scripts/video_gen.py --mode start_end --prompt "描述文字" --first "首图URL" --last "尾图URL"

# 主体参考（人脸一致）
python3 {baseDir}/scripts/video_gen.py --mode subject --prompt "描述文字" --subject "人脸图片URL"

参数说明#

参数说明必填--mode模式：text / image / start_end / subject是--prompt视频描述文本是--image图生视频的首帧图片URLimage模式必填--first首尾帧模式的首帧图片URLstart_end模式必填--last首尾帧模式的尾帧图片URLstart_end模式必填--subject主体参考模式的人脸图片URLsubject模式必填--duration视频时长：6 或 10（秒）否，默认6--resolution分辨率：720P / 1080P否，默认1080P--output输出文件名（默认 output.mp4）否

模型说明#

模式模型说明text（文生视频）MiniMax-Hailuo-2.3标准文生视频image（图生视频）MiniMax-Hailuo-2.3以图为首帧生成视频start_end（首尾帧）MiniMax-Hailuo-02开头结尾两图生成视频subject（主体参考）S2V-01保持人物特征一致

输出说明#

• 视频文件保存到 --output 指定路径（默认为当前目录的 output.mp4）
• Agent 负责将生成的视频文件发送给用户

注意事项#

• 视频生成是 异步过程，需要轮询等待（约10-60秒）
• 推荐轮询间隔：10秒
• 图片 URL 需要是公开可访问的链接
• 主体参考模式涉及人脸图片，请确保已获得图片当事人授权

API 文档#

• API Key 管理： https://platform.minimaxi.com
• 接口文档： https://platform.minimaxi.com/docs/llms.txt