在 ComfyUI 的 MiniMax H3 MiniMaxH3AddGuide 中,目标秒数按 round(秒数 × 24) 换算为 frame_idx,然后检查锚点与 guide 长度是否都落在生成视频的帧范围内。负 frame_idx 表示从视频结尾倒数,不是片头之前的时间。每个 guide 都要单独核对,尤其是修改输出时长或使用多帧 guide 时。
先把秒数换成帧号
H3 多帧模板使用 24fps 作为 frame_idx 的时间坐标,并以秒数乘 24 后四舍五入计算帧号。这只是坐标换算,不会改变生成片长。例如,目标时间为 1.5 秒时,帧号是 36。结果遇到小数时按公式取整;应记录最终传给节点的帧号,而不是假设节点直接接收秒数。
在工作流的 guide 区块中,找到 Frame Index 和 Math Expression,确认传入 MiniMaxH3AddGuide 的值。如果手动填写 frame_idx,也使用同一换算方式。不要拿输入素材标注的帧率替代模板规则:官方文档给出的 H3 guide 坐标是 24fps。
锚点之外还要核对 guide 长度
锚点本身不能说明 guide 一定放得下。H3 文档要求 frame index 加上 guide 长度处于生成时长范围内。对非负锚点,可用以下算术规划筛查,其中 N 是输出总帧数:
start = frame_idxend = start + guide_length- 规划区间记为
[start, end),与[0, N)比较。
例如,从第 60 帧开始、长度为 22 帧时,区间为 [60, 82),按从零开始的帧号覆盖 60 至 81。这是统一的半开区间算术,不保证 MiniMaxH3AddGuide 接受该输入:所引文档要求索引加 guide 长度处于生成时长内,但没有说明所有自定义长度的端点语义。计算结果超出范围时,应作为规划警示并在工作流中调查;尤其是临界值,须核实当前节点行为后再判断能否接受。应从工作流读取实际 guide 长度和输出帧数,不要凭四舍五入后的显示时长推断。
负 frame_idx 从视频末尾倒数。所引 H3 guide 没有说明负锚点与多帧 guide 长度如何共同确定占用区间,因此应先在当前 MiniMaxH3AddGuide 工作流中核实其位置和长度行为,再判断范围。
按顺序执行边界检查
- 从当前工作流读取输出总帧数。对于原生 H3 时长设置,确认配置采用
17k+5帧网格并据此取得N;否则先取得已配置或实际生成的帧数。 - 对每个目标时间使用
round(秒数 × 24),把结果写在对应 guide 旁,作为它的frame_idx。 - 记录 guide 的实际帧长度。单张静帧与多帧 batch 不同;应使用 guide 输入的帧数,而非只看源文件显示的时长。
- 对非负锚点,使用统一帧数约定计算半开区间,并将超出
[0, N)的结果标为需要修正或调查。 - 将范围已核对的 guide 串接到 H3 工作流。输出时长或 guide 媒体发生变化时,重新计算帧数和范围。
假设算例:输出为 124 帧
下表是算术假设,不代表实际运行或检查过工作流。N = 124 符合文档所述 17k+5 网格(k = 7),但不表示任何特定工作流实际生成 124 帧。Guide 长度按帧数计,规划区间采用左闭右开形式 [start, start + length);终点不包含在区间内,因此终点等于 N 时并未包含第 N 帧。
| 目标秒数 | 换算帧号 | Guide 长度 | 规划的不包含终点 | 对 [0, 124) 的算术筛查 |
|---|---|---|---|---|
| 1.5 秒 | 36 | 22 | 58 | 在区间内:[36, 58) |
| 3.0 秒 | 72 | 22 | 94 | 在区间内:[72, 94) |
| 5.0 秒 | 120 | 5 | 125 | 区间超出:[120, 125);终点超过 N |
| 4.0 秒 | 96 | 28 | 124 | 终点等于 N:[96, 124) |
按此算术约定,124 帧输出的帧标签是 0 至 123。第三行超出输出范围,第四行恰好到不包含终点的边界。此计算用于筛查非负锚点;恰好到边界时,仍应在当前工作流确认节点行为后再判断节点是否接受。
超界时如何处理及功能边界
如果规划区间延伸到输出之外,可测试提前锚定、在输入和工作流支持时缩短 guide,或增加生成时长后重新计算。这些是作者建议的调整,不是官方保证,也不保证保留特定构图或动作。对负锚点,应先在当前工作流核实其位置及多帧行为;不要用它绕过尚未解决的正锚点范围警示。
MiniMaxH3AddGuide 是一种条件引导:原生工作流仍从空 latent 开始采样。文档将其与 video-to-video 编辑区分开,也说明 denoise 不像 V2V 那样缩放 guide 强度。guide 可以在某帧锚定构图,但这不代表输入片段的每个中间画面都会被复现。多帧 guide 输入另有 17k+5 长度网格的裁切规则;少于 5 帧时只使用第一张图。这些输入规则与锚点相对生成时长的边界检查是两回事。
常见追问
换算时能不能使用源视频的帧率?
对这个模板的 frame_idx 换算不能。文档规则是 round(秒数 × 24)。参考视频的帧率读取方式属于另一项工作流细节,不改变这里的 guide 坐标规则。
为什么工作表使用半开区间?
这样帧数算术是明确的:[start, end) 包含 end - start 个帧号;终点等于 N 表示到达但不包含该边界。矩形的几何右边界 x + width = W 同样是合法的半开区间算例;像素 W - 1 是最后一个包含的坐标。这些是计数约定,不是对每个自定义节点内部实现的断言。对于 N 帧输出,锚点等于 N 已超出普通从零开始的帧号范围。
在边界检查前怎样确定 `N`?
使用已配置的 H3 时长和文档所述 17k+5 帧网格,或从工作流读取实际输出帧数。N 未知时,不要把边界检查标为通过。
来源与下一步
- ComfyUI MiniMax H3 Multiframe Reference Workflow
- ComfyUI MiniMax H3 Text-to-Video, Image-to-Video, and Reference-to-Video Workflows
本文依据公开文档解释操作,并使用明确标注的假设验收示例,不是软件实测。控件与可用功能可能变化,请对照所引手册和你的安装版本。
若你在 Imagild 中继续创作,可将输入要求和验收清单带到微电影工作台。上文讨论的外部软件控件属于其各自产品。