并发提交|Hailuo H3 视频生成
Run Hailuo H3 text, image, and multimodal video side by side — up to 9 images, 3 videos, 3 audios
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- video1
- video2
- video3
- audio1
- audio2
- audio3
- api_config
- future
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-768Por2K. That's it; no 1080p middle ground.ratio- used by T2V and Multi (includingadaptive); I2V ignores it and follows the input frame.image1…image9- I2V usesimage1as the required first frame andimage2as an optional last frame; Multi opens the full nine-image bank plusvideo1…video3andaudio1…audio3as 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 1refs that don't resolve - the tag numbering is by connected slot order, and the pack compacts gaps (skipimage2, and what you connected asimage3becomes@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.
Inputs (23)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | hailuo-h3-t2v | Hailuo H3 domestic/global task type: text-to-video, first/last-frame image-to-video, or multimodal reference video. | Hailuo H3 国内/海外支持文生视频、首尾帧图生视频和多模态参考生视频。 |
| prompt | STRING | Required 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 指代素材。 | |
| seconds | COMBO | 5 | Hailuo H3 supports 5 to 15 seconds. | Hailuo H3 支持 5 到 15 秒。 |
| resolution | COMBO | 768P | Hailuo H3 output resolution: 768P or 2K. | Hailuo H3 输出分辨率支持 768P 或 2K。 |
| ratio | COMBO | 16:9 | Used by H3 T2V and Multi, including adaptive; I2V follows the input frame. | H3 T2V 与 Multi 使用,支持 adaptive;I2V 跟随输入帧。 |
| image1opt | IMAGE | H3 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 张图。 | |
| image2opt | IMAGE | H3 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 张图。 | |
| image3opt | IMAGE | H3 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 张图。 | |
| image4opt | IMAGE | H3 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 张图。 | |
| image5opt | IMAGE | H3 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 张图。 | |
| image6opt | IMAGE | H3 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 张图。 | |
| image7opt | IMAGE | H3 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 张图。 | |
| image8opt | IMAGE | H3 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 张图。 | |
| image9opt | IMAGE | H3 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 张图。 | |
| video1opt | VIDEO | H3 Multi reference video 1, up to 3 videos. | H3 Multi 参考视频 1,最多 3 个。 | |
| video2opt | VIDEO | H3 Multi reference video 2, up to 3 videos. | H3 Multi 参考视频 2,最多 3 个。 | |
| video3opt | VIDEO | H3 Multi reference video 3, up to 3 videos. | H3 Multi 参考视频 3,最多 3 个。 | |
| audio1opt | AUDIO | H3 Multi reference audio 1, up to 3 audios. | H3 Multi 参考音频 1,最多 3 个。 | |
| audio2opt | AUDIO | H3 Multi reference audio 2, up to 3 audios. | H3 Multi 参考音频 2,最多 3 个。 | |
| audio3opt | AUDIO | H3 Multi reference audio 3, up to 3 audios. | H3 Multi 参考音频 3,最多 3 个。 | |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。 |
| seedopt | INT | 00–18446744073709550000 | ComfyUI 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)
| Name | Type | Description |
|---|---|---|
| future | SEEDANCE_VIDEO_FUTURE | — |