🎬 MiniMax H3 — ComfyUI 实操完整文档

一、ComfyUI 原生节点详解（源码级）

源码: comfy_extras/nodes_minimax_h3.py（ComfyUI ≥ v0.30.0 内置，无需第三方插件）

节点 1: EmptyMiniMaxH3LatentAV

节点 2: MiniMaxH3ImageToVideo（T2V/I2V/FL2VA）

节点 3: MiniMaxH3ReferenceToVideo（Ref2VA）

节点 4: MiniMaxH3SigmaShift

二、三种工作流拓扑（官方模板）

2.1 T2V / I2V 工作流（打包节点版）

官方模板用打包节点 4c314f31-...（一键节点），内部封装了 CLIPLoader + UNETLoader + VAELoader×2 + MiniMaxH3ImageToVideo + KSampler + VAEDecode + CreateVideo 的完整链路。

打包节点的 widget 参数：

2.2 R2V 工作流（底级节点版）

R2V 模板不用打包节点，而是完整的底级节点拓扑，给用户最大控制力：

帧数计算公式（ComfyMathExpression 节点）：

max(5, round(a * 24)) + (5 - (max(5, round(a * 24)) % 17)) % 17

# a = duration_seconds (PrimitiveFloat)
# 效果：将秒数转为帧数后 snap 到 17k+5 网格
# 例: 5s → round(5*24)=120 → (5-(120%17))%17 = (5-1)%17=4 → 120+4=124

R2V 采样器选择：res_multistep（不是 euler！）+ simple scheduler + 20步

三、API 提交格式（编程驱动 ComfyUI）

3.1 ComfyUI API JSON 格式（通过 /prompt 端点）

从工作流模板逆向得到的实际 API 参数映射：

T2V 提交格式

{
  "task": "t2va",
  "prompt": "integrated_multimodal_description: [Shot 1]...\noverall_soundscape:...\nnon_diegetic_music:...",
  "conditions": [],
  "target": {
    "short_edge": 768,
    "aspect_ratio": "16:9",
    "duration_seconds": 10
  },
  "seed": 0
}

I2V / FL2VA 提交格式

{
  "task": "fl2va",
  "prompt": "For the target video, at 0.00 seconds...\n\nintegrated_multimodal_description:...",
  "conditions": [
    {
      "type": "image",
      "uri": "file:///data/image.png",
      "role": "keyframe",
      "frame_index": 0     // 0=首帧; duration末=尾帧
    }
  ],
  "target": {
    "short_edge": 768,
    "aspect_ratio": "auto",   // auto = 跟随输入图比例
    "duration_seconds": 8
  },
  "seed": 0
}

Ref2VA 提交格式

{
  "task": "ref2va",
  "prompt": "subject_definitions:\n<Subject 1> is...\n\nsummary:\n[reference generation]...\n\nretention_analysis:\n...\n\ndetailed_description:\n...",
  "conditions": [
    {"type": "image", "uri": "file:///ref1.png", "role": "reference"},
    {"type": "video", "uri": "file:///ref.mp4", "role": "reference"},
    {"type": "audio", "uri": "file:///voice.mp3", "role": "reference"}
  ],
  "target": {
    "short_edge": 768,
    "aspect_ratio": "auto",
    "duration_seconds": 5
  },
  "seed": 0
}

3.2 SGLang API 额外参数

SGLang 支持更丰富的采样控制：

四、采样参数与分辨率规则

4.1 官方推荐参数

4.2 分辨率规则（源码 adapt_canvas）