Video Generation MiniMax

使用 MiniMax 视频生成 API 创建视频。支持4种生成模式：

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

前置要求

• - 安装 Python 依赖：pip3 install requests
• 设置环境变量 MINIMAXAPIKEY

使用方法

方式一：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/videogen.py --mode startend --prompt 描述文字 --first 首图URL --last 尾图URL
python3 {baseDir}/scripts/video_gen.py --mode subject --prompt 描述文字 --subject 人脸图片URL

参数说明

参数	说明	必填
--mode	模式：text/image/start_end/subject	是
--prompt

视频描述文本 | 是 | | --image | 图生视频的首帧图片URL | image模式必填 | | --first | 首尾帧模式的首帧图片URL | start_end模式必填 | | --last | 首尾帧模式的尾帧图片URL | start_end模式必填 | | --subject | 主体参考模式的人脸图片URL | subject模式必填 | | --duration | 视频时长：6/10 | 否，默认6 | | --resolution | 分辨率：720P/1080P | 否，默认1080P | | --output | 输出文件名 | 否，默认 output.mp4 |

示例

bash

文生视频

python3 {baseDir}/scripts/video_gen.py --mode text --prompt 镜头拍摄一个女性坐在咖啡馆里，女人抬头看着窗外

图生视频

python3 {baseDir}/scripts/video_gen.py --mode image --prompt Contemporary dance --image https://example.com/image.png

首尾帧生成

python3 {baseDir}/scripts/videogen.py --mode startend --prompt A little girl grow up --first https://example.com/start.jpg --last https://example.com/end.jpg

主体参考

python3 {baseDir}/scripts/video_gen.py --mode subject --prompt 在街头走路的男士 --subject https://example.com/face.jpg

数据来源

• - API Key：从环境变量 MINIMAXAPIKEY 读取
• API 文档：https://platform.minimaxi.com/docs/llms.txt

注意事项

• - 视频生成是异步过程，需要轮询任务状态
• 推荐轮询间隔为10秒
• 生成完成后自动下载视频到你的工作空间 {WorkspaceDir}/video-generation/目录下随后发送给用户
• 模型版本：文生视频用 MiniMax-Hailuo-2.3，主体参考用 S2V-01