Nodes/ComfyUI-MiniMaxH3-Myang/沐阳 H3 · 导演台(全功能)
ComfyUI Node

沐阳 H3 · 导演台(全功能)

One node that runs a whole storyboarded H3 shoot

By civilcoco·Created 3 days ago·Updated 3 days ago· 1
沐阳 H3 · 导演台(全功能)
  • h3
  • model
  • sampler
  • media
  • ref_video
  • ref_audio
  • 前段视频
  • 前段音频
  • 二采模型
  • images
  • audio
  • plan_json
  • fps
source_mode导演台分镜卡(手动逐镜头)
timeline_json{"version": 2, "shots": [{"id": "shot_1", "enabled": true, "duration_seconds": 5.0, "brief": "镜头 1", "prompt": "", "asset_mode": "仅本镜头", "assets": []}]}
script_fallback
total_seconds60
segment_seconds10.0
llm_enabledtrue
llm_service
task_mode纯生成(不用参考视频)
resolution480P
aspect_ratio16:9
width864
height480
steps25
denoise1.00
schedulersimple
noise_seed0
context_length22
ref_image_size匹配生成分辨率
二采开启false
二采模式放大 + 二采(推荐)
二采分辨率832P
二采自定义宽1664
二采自定义高928
二采步数4
二采重绘幅度0.20
二采调度器beta
二采采样器res_multistep
二采放大方式neural_3d (神经3D Latent放大·推荐)
二采分块帧数4
二采Latent模型
二采精度fp16(推荐·省显存)
二采时间分块16
二采轮数1
二采种子策略每轮沿用同一种子
save_segmentstrue
segment_prefixvideo/H3_导演台
save_raw_segmentsfalse
参考视频分辨率匹配参考视频原分辨率
参考视频自定义宽1920
参考视频自定义高1080
起始段1
skill_presetauto
skill_text
vlm_serviceoff

This is the pack's flagship, the node the whole thing is named after. 沐阳 H3 · 导演台(全功能) (H3Director) is a single node that organizes the entire job - storyboard, media, generation, seams, and optionally a second-pass upscale - into one runnable unit. The bundled quick-start workflow is only seven nodes: 沐阳 H3 加载器, 沐阳 H3 取模型, a KSampler select, this, and a video output. Everything else the README talks about as separate machinery - the Media Agent, the segment plan, the anchor long video, Turbo scheduling, second pass - is orchestrated from inside it.

Underneath it's not magic: the Director reuses the same existing Myang nodes as building blocks, so old workflows and the individual advanced nodes don't get replaced. But instead of hand-wiring a dozen nodes per segment, you fill in storyboards or hand the Director a script, and it builds the timeline.

Two ways to build a timeline

  • Manual storyboard (source_mode defaults to 导演台分镜卡) - each shot card gets a title, prompt, duration, and its own media. Durations snap to H3's 17k+5 frame grid. One card accepts up to 9 images, 3 videos, and 3 audio files. There's a shared-media area for character images, locations, and music used throughout; media on a card belongs to that shot. Refer to items as @图片1, @视频1, @音频1.
  • Agent / long-script split - with llm_enabled, an LLM builds the timeline from total duration, per-segment duration, the media inventory, and writing rules. script_fallback holds the script (or convert that widget to an input and connect an Agent myang_prompt). skill_preset (default auto) picks a writing skill for the segment-prompt structure, and skill_text is your own rules on top. With the LLM disabled, the input prompt takes the local splitting path and burns zero tokens.

task_mode picks the generation job: pure generation (no reference video), motion transfer (each segment follows its slice of the reference video - a motion-transfer card can pick its own action source, else the global ref_video is used), or video continuation. llm_service and vlm_service control which configured LLM/VLM backs the split and whether a VLM first describes the shared media so the LLM can decide what to reference.

The settings that matter most

  • h3 / model / sampler - the loader bundle, the first-pass model (base or Turbo-joined both go here), and a sampler node.
  • resolution / aspect_ratio / steps / denoise / scheduler / noise_seed - the generation contract; simple scheduler and denoise 1.0 are the Turbo-friendly defaults.
  • context_length - the continuity window (22 default; same scale as everywhere else in the pack).
  • 起始段 (start_segment) - resume support for motion transfer: 1 re-runs everything; on a resume you set the first un-generated segment and connect the previous segment's finished clip to 前段视频, whose tail only seeds the anchor (it never enters the ref2va reference channel). 前段音频 is its optional soundtrack for the audio seam.
  • The whole 二采… family - second-pass mode, resolution, steps, denoise, upscaler, chunking, passes and seed strategy, all inline. 二采模型 takes the Ref2VA base model before the Turbo LoRA.
  • save_segments / segment_prefix / save_raw_segments - per-segment output so a crash doesn't cost you everything.

Outputs: images, audio, the plan_json it executed, and fps.

LLM services

Open ComfyUI Settings → Myang_node → LLM Service Settings. It supports OpenAI-compatible APIs and Ollama, multiple URL/API-key routes per service, round-robin or primary-route-first selection, and cooldown/failover after rate limits and timeouts. Keys are never returned to the browser, and config lives in user/default/Myang_node/config/llm_services.json.

Install

ComfyUI Manager search "ComfyUI-MiniMaxH3-Myang", or git clone https://github.com/civilcoco/ComfyUI-MiniMaxH3-Myang into custom_nodes, restart, hard-refresh. No extra Python deps. Load example_workflows/Minimax_H3_Myang_Director_CN.json, pick your own models, media, prompts and seed, render two segments at a 22-frame context, inspect the seam - picture and sound - before scaling up. And the standing H3 license reminder: local weights are geofenced out of the US, EU, UK and South Korea.

Category沐阳 H3/导演台

Inputs (53)

NameTypeDefaultDescription
h3MYANG_H3
modelMODEL一采模型;基础模型或 Turbo 联合模型都直接接这里
samplerSAMPLER
source_modeCOMBO导演台分镜卡(手动逐镜头)2 options: 导演台分镜卡(手动逐镜头), Agent / 长剧本智能切分
timeline_jsonSTRING{"version": 2, "shots": [{"id": "shot_1", "enabled": true, "duration_seconds": 5.0, "brief": "镜头 1", "prompt": "", "asset_mode": "仅本镜头", "assets": []}]}
script_fallbackSTRING智能切分时作为剧本;可把此控件转换为输入后连接 Agent myang_prompt
total_secondsFLOAT601–3600
segment_secondsFLOAT10.04–20
llm_enabledBOOLEANtrue
llm_serviceCOMBO1 options: 未配置 LLM 服务
task_modeCOMBO纯生成(不用参考视频)3 options: 动作迁移(跟随参考视频), 视频续写(接着往下演), 纯生成(不用参考视频)
resolutionCOMBO480P12 options: 360P, 416P, 480P, 540P, 640P, 720P, +6
aspect_ratioCOMBO16:98 options: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, +2
widthINT86432–16384
heightINT48032–16384
stepsINT251–200
denoiseFLOAT1.000.01–1
schedulerCOMBOsimple3 options: simple, beta, normal
noise_seedINT00–18446744073709550000
context_lengthCOMBO224 options: 22, 5, 39, 56
ref_image_sizeCOMBO匹配生成分辨率5 options: 匹配生成分辨率, 最大1K面积, 最大1.5K面积, 最大2K面积, 匹配素材(原尺寸)
二采开启BOOLEANfalse
二采模式COMBO放大 + 二采(推荐)3 options: 放大 + 二采(推荐), 同分辨率二采(不放大), 仅放大(不二采·最快)
二采分辨率COMBO832P9 options: 540P, 640P, 720P, 768P, 832P, 928P, +3
二采自定义宽INT166432–8192
二采自定义高INT92832–8192
二采步数INT41–100
二采重绘幅度FLOAT0.200.01–1
二采调度器COMBObeta3 options: beta, simple, normal
二采采样器COMBOres_multistep2 options: res_multistep, euler
二采放大方式COMBOneural_3d (神经3D Latent放大·推荐)4 options: neural_3d (神经3D Latent放大·推荐), latent (latent空间放大·jingchen573方式), pixel (像素放大·自用版工作流方式), nvidia_rtx_vsr (NVIDIA RTX 视频超分·实验)
二采分块帧数INT41–64
二采Latent模型COMBO神经3D放大权重;其他放大方式会自动隐藏
二采精度COMBOfp16(推荐·省显存)3 options: fp16(推荐·省显存), fp32(最高稳定性), bf16(实验)
二采时间分块INT161–128
二采轮数INT11–8
二采种子策略COMBO每轮沿用同一种子2 options: 每轮沿用同一种子, 每轮种子 +1
save_segmentsBOOLEANtrue
segment_prefixSTRINGvideo/H3_导演台
save_raw_segmentsBOOLEANfalse
参考视频分辨率COMBO匹配参考视频原分辨率动作迁移/视频续写的参考视频预处理;默认保持原尺寸,最高 1080P
参考视频自定义宽INT192032–1920
参考视频自定义高INT108032–1920
起始段INT11–12仅动作迁移:从第几段开始生成。1=整条重跑;断点续跑时填未生成的那一段,并把上一段成片接到『前段视频』
skill_presetCOMBOauto智能切分的写作技能:决定每段提示词的输出结构、分镜格式和素材标签写法。auto 先用一次很短的调用按剧本选技能
skill_textSTRING自定义写作规则,排在所选技能之前,优先级最高
vlm_serviceCOMBOoff开启后先让 VLM 看一遍每个公共素材,把画面内容写进清单,LLM 才能按内容判断每段该引用哪个素材
mediaoptMINIMAX_H3_MEDIA
ref_videooptIMAGE
ref_audiooptAUDIO
前段视频optIMAGE动作迁移断点续跑:上一段已生成的成片。只用它的结尾做段间锚点上下文,不会作为 ref2va 参考视频
前段音频optAUDIO可选:上一段成片的音轨,用于声音接缝
二采模型optMODEL导演台二采使用的 Ref2VA 基模;接 Turbo LoRA 之前的模型

Outputs (4)

NameTypeDescription
imagesIMAGE
audioAUDIO
plan_jsonSTRING
fpsFLOAT