h3.c交互式生成会话深度玩转10个内置命令高效迭代你的视频提示词【免费下载链接】h3.cMiniMax H3 inference engine for Mac computers项目地址: https://gitcode.com/gh_mirrors/h3/h3.ch3.c 是运行在 Mac 上的 MiniMax H3 视频生成模型推理引擎内置 Iris 风格的交互式生成会话模型、提示词条件、DiT 和视频解码器常驻内存让你在同一会话里反复输入提示词、调整参数、对比出片无需每次都重新加载模型。本文带你用 10 个内置命令搭建高效的视频提示词迭代工作流。一键构建并进入交互式会话只需两条命令即可开启会话假设 Hugging Face 快照已放在./MiniMax-H3且系统安装了 FFmpeg/FFprobemake -j8 ./h3 -d ./MiniMax-H3 --width 512 --height 512构建规则见 Makefile。关键在于不带-p参数启动——此时不会执行单条生成而是进入交互模式打印H3 Interactive Mode与当前设置等待你在h3提示符后输入直接输入一行提示词 → 立即生成一条编号视频输入!开头的命令 → 调整会话参数或管理参考素材。交互逻辑的入口与命令分发都在 h3_cli.c 中实现命令清单定义在 print_help()。会话启动时会自动创建一个临时目录如/tmp/h3-XXXXXX见 mkdtemp 逻辑每次生成的视频按顺序保存为video-0001.mp4、video-0002.mp4……提示符支持多行输入和历史记录基于 linenoise.c 封装历史持久化到~/.h3_history上限 500 条用方向键即可调出上一次的提示词继续修改——这本身就是迭代工作流的一半。 为什么交互模式比反复敲 CLI 快会话会缓存 BF16 提示词嵌入、已准备的 DiT 和视频 VAE!cache可查看状态换种子重跑同一提示词时跳过大部分加载与编码开销。10个核心命令速查表命令功能典型场景!again原样重跑上一条提示词换种子后对比同一画面!seed [N\|random]设置/查看随机种子固定结果或随机探索!seconds [N]按 24 fps 设置时长快速短片迭代!steps [N]设置去噪步数速度与细节权衡!show [on\|off]开关去噪过程实时预览观察画面逐步成形!size [WxH]/!render-size设置输出尺寸/内部渲染尺寸调画布比例、降内尺寸提速!first [PATH\|clear]/!last首帧/尾帧锚点FL2VA 路径控制画面起止!ref-image PATH/!refs添加/列出有序参考图Ref2VA 路径让画面引用指定人物/物体!save [PATH]/!open复制/自动打开最近视频导出满意结果!status/!cache/!help查看设置/缓存/完整命令列表随时核对当前状态下面逐个拆解用法与迭代技巧。1.!again一键重跑上一条提示词h3 A red fox walks through fresh snow. h3 !seed random h3 !again!again会复用你最近一次成功生成的提示词重复逻辑、执行分支配合换种子立刻得到同一画面下的新变体是 A/B 对比最常用的组合。2.!seed [N|random]控制随机性!seed 42固定种子保证结果可复现!seed random进入随机模式每次生成自动抽新种子交互模式的默认行为见 h3_cli.h 的注释说明不带参数查看当前种子。提示词调优阶段建议开 random 找感觉满意后记下种子号固化结果。3.!seconds [N]按时长控制视频长度h3 !seconds 1.6 Seconds: 1.6 (39 aligned frames)H3 输出固定 24 fps帧数会向上对齐到合法时序形状5 17*n。常见档位22 帧约 0.9 秒、39 帧约 1.6 秒、107 帧约 4.5 秒详见 README 帧数表。迭代期用短时长省时间定稿再拉长。4.!steps [N]去噪步数权衡速度与细节!steps直接对应 CLI 的--steps取值范围 1–50。快速构思阶段用 4–7 步即可看出大致构图与运动确认方向后再回到 20 步左右的默认值。会话内所有参数修改即时生效下一条提示词立即采用新设置。5.!show [on|off]终端里看画面长出来开启后每次去噪过渡都会在支持的图形终端Kitty/Ghostty/iTerm2/WezTerm/Konsole见 h3_terminal.c中显示一帧中间画面h3 !show on h3 A surfer riding a sharp blue ocean wave, realistic spray. h3: preview 1/20 ...配合!zoom 1非 Retina 屏使用。若终端不支持图形协议命令会提示no supported graphical terminal detected检测分支。6.!size与!render-size画布与内部渲染分离h3 !size 768x768 # 输出尺寸需为 32 的倍数 h3 !render-size 512x512 # 内部以 512 渲染再上采样到输出尺寸 h3 !render-size native # 恢复原生渲染!render-size是提速利器模型在更小画布上计算、再用 vImage 放大到目标尺寸实现迭代构图阶段收益明显定稿时切回 native 保细节。7.!first/!last首尾帧锚点h3 !first opening.png h3 !last ending.png h3 The camera moves slowly around the subject. h3 !first clear # 随时移除锚点设置锚点会走 FL2VA 路径把起点画面和终点画面钉死中间运动交给提示词描述锚点设置逻辑。想控制镜头起止构图时非常实用。注意锚点与 Ref2VA 参考图互斥不能同时使用。8.!ref-image/!refs有序参考图h3 !ref-image person.png Added reference 1 as Picture 1: person.png h3 Make the person shown in Picture 1 wave to the camera. h3 !refs # 列出当前顺序 h3 !ref-remove 1 # 按序号删除参考图按添加顺序暴露为Picture 1、Picture 2……文件名对模型没有意义模型靠第几张图来理解引用添加逻辑。需要 Ref2VA checkpoint且图片参考最多 9 张、总参考最多 12 个。9.!save/!open把满意的结果落袋h3 !save my-video.mp4 # 复制最近一条生成视频到指定路径 h3 !open on # 之后每次生成完自动打开播放器!save不带参数会存为带时间戳的h3-时间戳.mp4保存逻辑会话目录里的video-0001.mp4等文件也可以直接拷走。10.!status/!cache/!help状态三件套h3 !status Size: 512x512 Frames: 22 requested, 22 generated (0.917 seconds) Steps: 6 | reuse: 1 | layers: 50 | core reuse: 4 | tokens: full | FC2: int8 grouped Seed: random First: none | References: 0 Show: on | open: on | output: /tmp/h3-AbCdEf h3 !cache Cache: embeddings 3 (12.4 MiB), DiT resident, video VAE resident!status一屏核对全部当前设置输出格式!cache确认会话缓存是否已热!help打印完整命令列表。迭代中改乱参数时!status是最好的仪表盘。推荐迭代工作流从粗到细三步走快速摸底!show on!seconds 1 低步数用一两分钟级别的短片验证构图和运动方向是否成立精调提示词利用多行输入写详细的 Context-IR 风格描述主体、动作、场景、镜头、光线、声音反复修改后!again!seed random抽 3–5 个变体对比定稿出片!status核对参数恢复默认档位!steps 20、!render-size native!save final.mp4导出。每一步的对照都发生在同一会话里模型与解码器常驻内存对比成本极低——这正是 h3.c 交互式会话的核心价值。常见问题与注意事项!show没反应确认终端是 Kitty/Ghostty/iTerm2/WezTerm/Konsole 之一其他终端会提示Display unavailable in this terminal.!ref-image报错需要 Ref2VA checkpoint且不能与!first/!last锚点混用音频参考独立音频参考必须搭配图像或视频参考使用时长 2–15 秒最多 3 段这属于 CLI 启动参数--ref-audio的能力会话命令中通过!ref-image管理视觉参考详见 README 参考素材章节;会话结束输入!quit或!exit退出历史自动写回~/.h3_history参数边界所有命令都做了严格校验非法输入会给出Usage:提示并拒绝修改process_command 分发不用担心改坏会话状态。延伸阅读README.md交互会话官方教程与锚点/参考图用法h3_cli.c交互式会话的完整实现命令解析、生成回调、输出管理h3.h核心参数结构h3_params定义对应各!命令可改的字段main.cCLI 参数与会话默认值的衔接逻辑掌握这 10 个命令后提示词迭代就从改一句、等一次加载变成了改一句、立刻看视频生成实验效率会有质的提升。【免费下载链接】h3.cMiniMax H3 inference engine for Mac computers项目地址: https://gitcode.com/gh_mirrors/h3/h3.c创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考