/video — 本地 AI 视频片段
工具:content-studio MCP → generate_video、generate_image、mux_audio、
free_memory、job_status。
1. 询问 — 一次性问题与选项
使用 AskUserQuestion(Claude Code)/ question(OpenCode);否则使用编号列表。
跳过用户已经提及的内容。
| 问题 | 选项 |
|---|---|
| 模型 | 快速 — MiniMax-H3 4 位(41 GB,quality:"fast")· 最佳 — MiniMax-H3 8 位(70 GB,quality:"quality") |
| 画面比例 | 竖屏 512×896 · 横向 896×512 · 方形 640×640 |
| 时长 | ~2 秒(49 帧) · ~4 秒(97 帧) · ~8 秒(193 帧) |
| 起始方式 | 仅文本 · 先生成一张静态图,再制作动画 · 我自己的图片(询问路径) |
片段自带生成的配乐。模型会对帧数向上取整 (49 → 56 帧 ≈ 2.3 秒,24 fps)。在快速模型上,一个 512×896 的小片段约需 2 分钟。
竖屏适合人物和街景,但宽阔的地平线镜头 (海洋、风景)有时会在 512×896 下出现侧翻——针对这类场景请使用横向, 或者在使用片段前先检查一帧。
2. 准备
- “先生成一张静态图”:运行
generate_image(质量预设,相同宽高比),然后 将其路径作为first_frame_image传递。 - 在使用 8 位模型之前,调用
free_memory()— 它需要约 70 GB。 - 编写一个镜头风格提示:主体 + 动作、镜头运动(推拉、环绕、手持、 缓慢推进)、光照、氛围。每个片段只写一个镜头。
3. 生成
generate_video(prompt, quality, width, height, num_frames, first_frame_image) →
轮询 job_status(job_id, wait_seconds=40) 直到完成。
对于多镜头的作品,每个镜头作为一个独立片段生成,然后交给 /reel
(HyperFrames 剪辑)进行拼接,配合音乐和字幕。
4. 交付
提供 MP4 文件的路径(位于 ~/ai/content-studio/outputs/video/ 下)、时长和大小。
提供选项:重来一次(新种子)、添加音乐(/song 然后 mux_audio),或制作合成片段。
长时间任务
工具调用在约 45 秒内返回(MCP 客户端的超时时间为 60 秒)。如果结果显示
status: "running",持续调用 job_status(job_id) — 每次调用最多等待 40 秒 —
并在两次调用之间告知用户进度。即使聊天或 MCP 服务器重新启动,任务也会继续运行;
list_jobs() 可以重新找到它们。