Kling 视频生成
Kling t2v, i2v and O3 reference video in one node — with a warning label
- image1
- image2
- image3
- image4
- api_config
- video
- video_url
- task_id
- response
Kling is one of the marquee closed video models (Kuaishou's), and this node front-ends the biggest slice of it: text-to-video across the standard/pro/turbo/4k/O3 tiers, image-to-video with an optional end frame, and O3 reference-to-video using up to four images. It's the "make the video from scratch" sibling to the pack's Kling_Edit_Video node, and for most Kling work it's the one you'll reach for first.
It's an API wrapper from T8mars/ComfyUI_Seedance, so: key from api.seedance.nz, no GPU, requests only.
How it works
Pick a model and the node adapts its input slots. T2V models want just the prompt. I2V models grow image1 (required) and image2 (optional end frame). O3 R2V models use image1 through image4, submitted in the order you connected them. The ratio you choose is passed through as metadata.ratio unless it's adaptive, and negative_prompt goes to metadata too. From there it's the pack's usual submit → poll → download → decode loop, with the resilient MP4 download chain everyone leans on.
The inputs that matter
- model - the long dropdown: t2v and i2v variants of kling-v3.0 std/pro, v3-turbo std/pro, v3-4k, and o3 std/pro/4k, plus the three o3-r2v models.
- prompt - up to 20480 characters.
- seconds - 5 or 10.
- ratio -
adaptiveor a fixed aspect. - negative_prompt - optional, forwarded to metadata.
- image1 (i2v, required), image2 (optional end frame), image1..4 (o3-r2v, in connected order).
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, key from api.seedance.nz/console, Seedance API Config into api_config.
Common issues - read this before picking an O3 r2v model
The README is refreshingly honest about what doesn't work yet. As of the last real test pass:
kling-o3-std-r2vandkling-o3-pro-r2vfail at submit with an upstream502- onlykling-o3-4k-r2vhas actually run end-to-end. If you pick std/pro r2v and it dies on submission, you're not doing anything wrong; it's the gateway's channel.- Motion,
kling-elements-advancedand lip-sync are not exposed as nodes at all - they need special structures or multi-step flows the pack deliberately skips.
Otherwise: i2v with no image1 fails validation (it's required), and if a r2v's references aren't holding character, the O3-4k path is the one with a known-good result to compare against. Kling is also one of the models where the "cheap drafts first" advice matters - 4k jobs are the priciest in the pack, so validate your prompt on 5-second std before spending on the big one.
Inputs (12)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | kling-v3.0-std-t2v | Kling task type. t2v uses prompt; i2v uses image1 and optional image2; o3-r2v uses up to 4 images. | Kling 任务类型:文生、图生/首尾帧、O3 参考生视频。 |
| prompt | STRING | Text prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。 | |
| seconds | COMBO | 5 | Kling supports 5 or 10 seconds. | Kling 支持 5 或 10 秒。 |
| ratio | COMBO | 16:9 | Aspect ratio forwarded as metadata.ratio when not adaptive. | 非 adaptive 时透传为 metadata.ratio。 |
| negative_prompt | STRING | Optional negative prompt forwarded to metadata. | 可选反向提示词,透传到 metadata。 | |
| image1opt | IMAGE | Optional Kling image 1. i2v uses image1 and optionally image2 as an end frame; r2v uses connected images in compacted order. | 可选 Kling 图片 1;图生视频使用 image1,可选 image2 作为尾帧;r2v 按已连接图片顺序提交。 | |
| image2opt | IMAGE | Optional Kling image 2. i2v uses image1 and optionally image2 as an end frame; r2v uses connected images in compacted order. | 可选 Kling 图片 2;图生视频使用 image1,可选 image2 作为尾帧;r2v 按已连接图片顺序提交。 | |
| image3opt | IMAGE | Optional Kling image 3. i2v uses image1 and optionally image2 as an end frame; r2v uses connected images in compacted order. | 可选 Kling 图片 3;图生视频使用 image1,可选 image2 作为尾帧;r2v 按已连接图片顺序提交。 | |
| image4opt | IMAGE | Optional Kling image 4. i2v uses image1 and optionally image2 as an end frame; r2v uses connected images in compacted order. | 可选 Kling 图片 4;图生视频使用 image1,可选 image2 作为尾帧;r2v 按已连接图片顺序提交。 | |
| 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 (4)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |
| video_url | STRING | — |
| task_id | STRING | — |
| response | STRING | — |