Nodes/ComfyUI Seedance/Hailuo H3 视频生成
ComfyUI Node

Hailuo H3 视频生成

9 images, 3 videos and 3 audios as references

By T8mars·Created 2 months ago·Updated 3 days ago· 31
Hailuo H3 视频生成
  • image1
  • image2
  • image3
  • image4
  • image5
  • image6
  • image7
  • image8
  • image9
  • video1
  • video2
  • video3
  • audio1
  • audio2
  • audio3
  • api_config
  • video
  • video_url
  • task_id
  • response
modelhailuo-h3-t2v
prompt
seconds5
resolution768P
ratio16:9
skip_errorfalse
seed0

Hailuo H3 is the flagship tier of MiniMax's video line, and this node front-ends six of its variants: domestic and global T2V, I2V (first/last frame), and Multi - the mode that makes H3 worth the upgrade. Multi lets you throw up to nine reference images, three reference videos and three reference audios at one generation, and then reference them from the prompt as @Image 1, @Video 1, @Audio 1. You're building a scene from a mood board inside a single node, which is not something the pack's older video nodes can do.

It's another API wrapper from T8mars/ComfyUI_Seedance - key from api.seedance.nz, zero local compute.

How it works

Standard async video flow under the hood: the node collects whatever media the selected model accepts, uploads local IMAGE/VIDEO/AUDIO references, maps them to the API's image/video/audio fields, submits, polls, and streams the MP4 back down with a header check. The front end is what does the heavy lifting here - switch model and the image/video/audio slots appear or vanish to match what that mode accepts, so you can't casually wire a video into T2V.

The inputs that matter

  • model - six choices: hailuo-h3-t2v, hailuo-h3-i2v, hailuo-h3-multi, and their -global- twins.
  • prompt - required for T2V and Multi (Multi prompts use the @Image 1 / @Video 1 / @Audio 1 syntax), optional for I2V.
  • seconds - 5 to 15.
  • resolution - 768P or 2K. H3 is a 2K-class model, which is its whole point over Hailuo 2.3.
  • ratio - used by T2V and Multi (including adaptive); I2V follows the input frame and doesn't send a ratio at all.
  • image1..image9, video1..video3, audio1..audio3 - the Multi reference pool. I2V uses image1 as the first frame and image2 as the optional last frame.

Outputs: video, video_url, task_id, response.

Installing it

Same as every node in this pack. ComfyUI Manager → search "ComfyUI Seedance", or:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
cd ../..
python -m pip install -r custom_nodes/ComfyUI_Seedance/requirements.txt

Restart, key from api.seedance.nz/console, Seedance API Config node into api_config.

Common issues

  • References not being used - check the mode. Multi is the only one that reads videos and audios; T2V takes no reference material at all.
  • @Video 1 reference ignored - the prompt references only work meaningfully in Multi mode, and the tooltip is explicit that Multi accepts up to 3 videos and 3 audios. Exceeding that, the extras are dropped.
  • Slow upload phase - up to 9 images + 3 videos + 3 audios is a lot of uploads, and the gateway rate-limits uploads per token. The node waits and retries; a long "uploading" phase before generation is normal, not a hang.

The honest framing, as with all closed-model nodes: your references leave the machine and land on a gateway you don't control, subject to the model's own content policy. For a model this good that can't run locally, that's the trade - and Multi is exactly the kind of job worth paying it for.

CategorySeedance

Inputs (23)

NameTypeDefaultDescription
modelCOMBOhailuo-h3-t2vHailuo H3 domestic/global task type: text-to-video, first/last-frame image-to-video, or multimodal reference video. | Hailuo H3 国内/海外支持文生视频、首尾帧图生视频和多模态参考生视频。
promptSTRINGRequired for T2V and Multi; optional for I2V. Multi prompts can reference @Image 1, @Video 1, and @Audio 1. | T2V 与 Multi 必填,I2V 可选;Multi 可用 @Image 1、@Video 1、@Audio 1 指代素材。
secondsCOMBO5Hailuo H3 supports 5 to 15 seconds. | Hailuo H3 支持 5 到 15 秒。
resolutionCOMBO768PHailuo H3 output resolution: 768P or 2K. | Hailuo H3 输出分辨率支持 768P 或 2K。
ratioCOMBO16:9Used by H3 T2V and Multi, including adaptive; I2V follows the input frame. | H3 T2V 与 Multi 使用,支持 adaptive;I2V 跟随输入帧。
image1optIMAGEH3 image 1. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 1;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image2optIMAGEH3 image 2. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 2;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image3optIMAGEH3 image 3. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 3;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image4optIMAGEH3 image 4. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 4;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image5optIMAGEH3 image 5. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 5;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image6optIMAGEH3 image 6. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 6;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image7optIMAGEH3 image 7. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 7;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image8optIMAGEH3 image 8. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 8;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
image9optIMAGEH3 image 9. I2V uses image1 as the first frame and image2 as the optional last frame; Multi accepts up to 9 images. | H3 图片 9;I2V 用 image1 作为首帧、image2 作为可选尾帧;Multi 最多支持 9 张图。
video1optVIDEOH3 Multi reference video 1, up to 3 videos. | H3 Multi 参考视频 1,最多 3 个。
video2optVIDEOH3 Multi reference video 2, up to 3 videos. | H3 Multi 参考视频 2,最多 3 个。
video3optVIDEOH3 Multi reference video 3, up to 3 videos. | H3 Multi 参考视频 3,最多 3 个。
audio1optAUDIOH3 Multi reference audio 1, up to 3 audios. | H3 Multi 参考音频 1,最多 3 个。
audio2optAUDIOH3 Multi reference audio 2, up to 3 audios. | H3 Multi 参考音频 2,最多 3 个。
audio3optAUDIOH3 Multi reference audio 3, up to 3 audios. | H3 Multi 参考音频 3,最多 3 个。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。
seedoptINT00–18446744073709550000ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。

Outputs (4)

NameTypeDescription
videoVIDEO
video_urlSTRING
task_idSTRING
responseSTRING