| name | mmx-video |
| description | Use mmx to generate videos via MiniMax Hailuo models. Use when the user wants to generate video clips, text-to-video, image-to-video, subject reference video, or start-end frame interpolation. Triggers on "生成视频", "文生视频", "图生视频", "Hailuo", "视频片段", "T2V", "I2V", "video generate". |
MiniMax 视频生成技能
使用 mmx video generate 生成视频片段（默认 6 秒，768P）。
默认原则：先引导用户描述画面，再转成专业提示词。视频生成耗时较长（1-3 分钟），提前告知用户。
工作流总览
用户描述需求
↓
【第一步】引导需求（4个问题）
↓
【第二步】选择模型和模式
↓
【第三步】转换提示词
↓
【第四步】生成并下载
第一步：引导需求
| 问题 | 目的 |
|---|
| 视频里想展示什么画面/场景？ | 核心内容 |
| 有参考图片吗？（首帧/末帧/角色参考图） | 决定模式 |
| 镜头怎么运动？（静止/推进/旋转/跟拍…） | 运镜描述 |
| 对速度或画质有要求吗？（快速出图 vs 高质量） | 选模型 |
第二步：选择模型和模式
| 场景 | 模型 | 标志 |
|---|
| 纯文字生视频（标准质量） | MiniMax-Hailuo-2.3（默认） | 无额外标志 |
| 纯文字生视频（快速出图） | MiniMax-Hailuo-2.3-Fast | --model MiniMax-Hailuo-2.3-Fast |
| 图片作为首帧（图生视频） | MiniMax-Hailuo-2.3 | --first-frame 图片路径 |
| 首帧+末帧插值（SEF模式） | Hailuo-02（自动切换） | --first-frame + --last-frame |
| 角色一致性视频 | S2V-01（自动切换） | --subject-image 角色图片 |
模型对比
| Hailuo-2.3（默认） | Hailuo-2.3-Fast |
|---|
| 速度 | 标准（~90-180s） | 更快（~30-60s） |
| 质量 | 更细腻 | 略低 |
| 适合 | 正式用途 | 快速预览 |
第三步：提示词转换
提示词结构（推荐格式）
[主体描述] [动作/状态] [场景/环境] [运镜指令] [氛围/风格]
运镜词汇表
| 用户描述 | 提示词 |
|---|
| 不动 | Static shot. / Fixed camera. |
| 慢推近 | Slow push in. / Dolly zoom. |
| 环绕 | 360-degree orbit. |
| 跟拍 | Tracking shot. |
| 俯视 | Aerial view. / Bird's-eye view. |
| 上升 | Camera rises slowly. |
| 第一人称 | POV shot. |
风格词汇表
| 风格 | 提示词 |
|---|
| 电影感 | cinematic, shallow depth of field, dramatic lighting |
| 纪录片 | documentary style, natural lighting |
| 动漫 | anime style, vibrant colors |
| 写实 | photorealistic, 8K, ultra-detailed |
| 梦幻 | dreamy, soft bokeh, pastel tones |
第四步：生成命令
mmx video generate \
--prompt "A woman walks through a cherry blossom forest. Slow tracking shot. Cinematic." \
--download output.mp4 \
--quiet
mmx video generate \
--model MiniMax-Hailuo-2.3-Fast \
--prompt "一只猫在阳光下伸懒腰。静止镜头。" \
--download cat.mp4 \
--quiet
mmx video generate \
--prompt "The person walks forward into the mist." \
--first-frame person.jpg \
--download walk.mp4 \
--quiet
mmx video generate \
--prompt "Smooth transition from dawn to dusk." \
--first-frame dawn.jpg \
--last-frame dusk.jpg \
--download timelapse.mp4 \
--quiet
mmx video generate \
--prompt "A detective walks into a rainy street." \
--subject-image character.jpg \
--download detective.mp4 \
--quiet
TASK=$(mmx video generate \
--prompt "Ocean waves at sunset." \
--async --quiet | python3 -c "import sys,json; print(json.load(sys.stdin).get('taskId',''))" 2>/dev/null)
echo "Task ID: $TASK"
mmx video task get --task-id "$TASK" --output json --quiet
mmx video download --task-id "$TASK" --out ocean.mp4
等待策略
| 场景 | 推荐方式 |
|---|
| 单个视频，可等待 | --download 文件名（默认轮询等待） |
| 批量生成 | --async 获取 task ID，轮询检查 |
| CI/自动化 | --async --non-interactive |
提示词最佳实践
- 用英文提示词：效果通常优于中文（模型训练偏英文）
- 句号结尾：每个描述元素用句号分隔
- 明确运镜：不写运镜 = 随机，建议始终指定
- 避免文字/logo：模型不善于在视频中渲染文字
- 6 秒限制：当前 Hailuo 系列固定 6 秒，复杂叙事需分段生成后拼接
注意事项
- 默认模型：
MiniMax-Hailuo-2.3（768P, 6s）
--last-frame 必须与 --first-frame 同时使用- 生成耗时：标准 90-180 秒，Fast 30-60 秒
- 内容审核：暴力/成人内容会触发过滤器（exit code 10）
- 始终加
--quiet 避免进度条干扰
