MiniMax 海螺视频生成#

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

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

前置要求#

• Python 3
• pip3 install requests

使用方法#

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图生视频的首帧图片 URL（image 模式）image 模式必填--first首尾帧模式的首帧图片 URLstart_end 模式必填--last首尾帧模式的尾帧图片 URLstart_end 模式必填--subject主体参考模式的人脸图片 URLsubject 模式必填--duration视频时长：6 或 10 秒，默认 6否--resolution分辨率：720P / 768P / 1080P，默认 768P否--output输出文件名，默认 output.mp4否

模型说明#

• 文生视频 / 图生视频： MiniMax-Hailuo-2.3（支持 768P / 1080P）
• 首尾帧视频： MiniMax-Hailuo-02（支持 768P / 1080P）
• 主体参考： S2V-01

⚠️ 注意：龚云荷的账户不支持 1080P，建议使用 --resolution 768P（已设为默认）。

示例（小说分镜）#

bash

python3 {baseDir}/scripts/video_gen.py \
  --mode image \
  --prompt "Cinematic winter scene in rural northern China. A young mother washes vegetables in icy well water. A little girl crouches nearby. Muted earth tones, film grain, shallow depth of field, melancholic atmosphere." \
  --image "/Users/gyh/Desktop/obsidian_file/GYH_file/AI小说/情节反转小说/女性向/周桂兰.png" \
  --duration 6 \
  --resolution 768P \
  --output "/Users/gyh/Desktop/obsidian_file/GYH_file/AI小说/情节反转小说/女性向/scene1.mp4"

API 配置#

使用前需设置环境变量 MINIMAX_API_KEY（从 https://platform.minimax.com 获取）。

bash

export MINIMAX_API_KEY="你的API Key"