Nodes/ComfyUI Seedance/并发提交|Hailuo H3 视频生成
ComfyUI Node

并发提交|Hailuo H3 视频生成

Run Hailuo H3 text, image, and multimodal video side by side — up to 9 images, 3 videos, 3 audios

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
  • future
modelhailuo-h3-t2v
prompt
seconds5
resolution768P
ratio16:9
skip_errorfalse
seed0

Hailuo is MiniMax's video model family, and H3 is the one that made waves when it dropped - the KB's closed-source-models doc frames it as the first credible open-weights answer to Veo's native-audio gap (and notes the license carries a weird geographic restriction for the local weights; the API you're calling here is a different door entirely). This node is the concurrent-submit wrapper around the pack's H3 generator: six models - domestic and global- overseas versions of t2v, i2v, and the big multimodal one - that fire in the background instead of blocking your graph.

Same wrapper pattern as every submit node in the pack: you fill in the params, it validates them synchronously, then pushes the job to a video thread pool and hands you a SEEDANCE_VIDEO_FUTURE. Wire that into the SeedanceConcurrent_Video_Await receiver and it'll wait on up to ten futures in parallel, returning finished VIDEO values in slot order. If you're comparing a t2v take against a multimodal take, this is how you run them at the same time instead of back-to-back.

The inputs that matter

  • model - hailuo-h3-t2v, hailuo-h3-i2v, hailuo-h3-multi, plus the three -global- variants.
  • prompt - required for T2V and Multi; optional for I2V (you can drive an i2v mostly off the frame). In Multi mode you address your reference material directly in the prompt with @Image 1, @Video 1, @Audio 1.
  • seconds - 5 to 15.
  • resolution - 768P or 2K. That's it; no 1080p middle ground.
  • ratio - used by T2V and Multi (including adaptive); I2V ignores it and follows the input frame.
  • image1image9 - I2V uses image1 as the required first frame and image2 as an optional last frame; Multi opens the full nine-image bank plus video1video3 and audio1audio3 as references.

Pack-standard extras: api_config, skip_error (placeholder video instead of killing a batch), and seed as a ComfyUI cache seed - fixed means an unchanged re-run reuses cached output rather than spending another metered call.

How it runs

Classic wrapper mechanics: the Multi path uploads your local images, videos, and audio automatically and maps them to the right reference fields in the request; the receiver does the polling and download, and a clip only counts as success after it passes the MP4 header check. The batch layout means a failed slot doesn't take the others down - raise mode will stop and name the slot, placeholder mode keeps the survivors.

Installing

# ComfyUI Manager: search "ComfyUI Seedance" → install → restart.
# or:
comfy node install 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

Just requests for a dependency, zero model downloads. API key via Seedance API Config, SEEDANCE_API_KEY, or config/.env.

Where people trip

  • Multi with no reference material - the model needs at least one connected image/video/audio; a pure-prompt Multi job will fail validation. That's what the t2v model is for.
  • @Image 1 refs that don't resolve - the tag numbering is by connected slot order, and the pack compacts gaps (skip image2, and what you connected as image3 becomes @Image 2). The console prints a hint when it renumbers.
  • I2V ratio confusion - don't fight the input frame; I2V doesn't send a ratio at all.

It's a cloud call end to end - prompts and reference media go to the gateway, and each clip is metered. Save results you like promptly; the result links are temporary.

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 (1)

NameTypeDescription
futureSEEDANCE_VIDEO_FUTURE