Nodes/ComfyUI Seedance/HappyHorse 1.1 视频生成
ComfyUI Node

HappyHorse 1.1 视频生成

The reference-image video node that builds a cast from a prompt

By T8mars·Created 2 months ago·Updated 3 days ago· 31
HappyHorse 1.1 视频生成
  • first_image
  • reference_image2
  • reference_image3
  • reference_image4
  • reference_image5
  • reference_image6
  • reference_image7
  • reference_image8
  • reference_image9
  • api_config
  • video
  • video_url
  • task_id
  • response
modelhappyhorse-1.1-t2v
prompt
seconds4
resolution720p
ratioadaptive
skip_errorfalse
seed0

HappyHorse 1.1 is a video model that lives behind an API, and its three modes are simple enough to explain over a coffee: t2v is pure text-to-video, i2v animates one seed frame, and r2v (reference-to-video) takes up to nine reference images so you can keep the same characters or style across shots. The r2v mode is the reason to seek this node out - you build a little cast sheet of 图1/图2 (image 1/image 2) references and the prompt can literally say "图1 walks toward 图2".

Like every node in T8mars/ComfyUI_Seedance, it's an API wrapper: key from api.seedance.nz, no local weights, requests as the only real dependency.

How it works

Pick a model and the node adapts its inputs. t2v wants just a prompt; i2v grows a required first_image; r2v expands to first_image plus reference_image2 through reference_image9. Gaps get compacted - if you only connect images 1, 3 and 5, the node submits them in connected order, so the "图N" numbering in your prompt follows what you actually connected, not the slot numbers. The aspect ratio you pick is forwarded as metadata.ratio and mapped upstream to the model's own aspectRatio. Everything else is the pack's standard submit → poll → download → decode pipeline.

The inputs that matter

  • model - happyhorse-1.1-t2v, happyhorse-1.1-i2v, or happyhorse-1.1-r2v.
  • prompt - up to 20480 characters. Required for t2v; optional for i2v; for r2v you can reference 图1..图9 by name.
  • seconds - 3 to 15. Note: no -1 "let the model decide" here - HappyHorse doesn't support it, unlike some other nodes in the pack.
  • resolution - 720p or 1080p only.
  • ratio - forwarded to the upstream aspect-ratio mapping.
  • first_image - required for i2v; doubles as 图1 for r2v.
  • reference_image2..9 - the rest of your cast.

Outputs: video, video_url, task_id, response.

Installing it

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 ComfyUI, grab a key from api.seedance.nz/console, connect a Seedance API Config node.

Common issues

  • r2v ignores your 9th image - it supports up to 9 total (first_image + 8 more), so connect within that limit.
  • "图2" in the prompt does nothing - in i2v mode only the first frame exists; the 图N syntax is an r2v feature.
  • Seconds=-1 rejected - HappyHorse doesn't take -1; pick 3–15.
  • Character drift across a multi-image r2v - that's the model's consistency ceiling, not a wiring bug. If references aren't holding, reorder so the most important character is 图1.

For a closed video model this is a cheap, low-friction way to test character consistency before committing to a pricier render. The pack ships happy-horse example workflows (文生/图生/参考生) you can load straight from the examples/ folder.

CategorySeedance

Inputs (17)

NameTypeDefaultDescription
modelCOMBOhappyhorse-1.1-t2vHappyHorse 1.1 task type. t2v uses prompt only; i2v uses first_image; r2v uses 1-9 reference images. | t2v 只用提示词;i2v 使用首帧图;r2v 使用 1-9 张参考图。
promptSTRINGText prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。
secondsCOMBO4HappyHorse supports 3-15 seconds and does not support -1. | 支持 3-15 秒,不支持 -1。
resolutionCOMBO720pHappyHorse supports 720p or 1080p. | HappyHorse 支持 720p 或 1080p。
ratioCOMBOadaptiveAspect ratio forwarded as metadata.ratio for upstream aspectRatio mapping. | 画幅会通过 metadata.ratio 映射给上游 aspectRatio。
first_imageoptIMAGERequired for happyhorse-1.1-i2v, and image 1 / 图1 for happyhorse-1.1-r2v. | i2v 必填;r2v 中作为图1。
reference_image2optIMAGEOptional r2v reference image 2; prompt can mention 图2. Gaps are compacted to connected order. | r2v 可选参考图 2,提示词可写图2;跳号会按连接顺序压缩。
reference_image3optIMAGEOptional r2v reference image 3; prompt can mention 图3. Gaps are compacted to connected order. | r2v 可选参考图 3,提示词可写图3;跳号会按连接顺序压缩。
reference_image4optIMAGEOptional r2v reference image 4; prompt can mention 图4. Gaps are compacted to connected order. | r2v 可选参考图 4,提示词可写图4;跳号会按连接顺序压缩。
reference_image5optIMAGEOptional r2v reference image 5; prompt can mention 图5. Gaps are compacted to connected order. | r2v 可选参考图 5,提示词可写图5;跳号会按连接顺序压缩。
reference_image6optIMAGEOptional r2v reference image 6; prompt can mention 图6. Gaps are compacted to connected order. | r2v 可选参考图 6,提示词可写图6;跳号会按连接顺序压缩。
reference_image7optIMAGEOptional r2v reference image 7; prompt can mention 图7. Gaps are compacted to connected order. | r2v 可选参考图 7,提示词可写图7;跳号会按连接顺序压缩。
reference_image8optIMAGEOptional r2v reference image 8; prompt can mention 图8. Gaps are compacted to connected order. | r2v 可选参考图 8,提示词可写图8;跳号会按连接顺序压缩。
reference_image9optIMAGEOptional r2v reference image 9; prompt can mention 图9. Gaps are compacted to connected order. | r2v 可选参考图 9,提示词可写图9;跳号会按连接顺序压缩。
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