Nodes/ComfyUI Seedance/Kling 视频生成
ComfyUI Node

Kling 视频生成

Kling t2v, i2v and O3 reference video in one node — with a warning label

By T8mars·Created 2 months ago·Updated 3 days ago· 31
Kling 视频生成
  • image1
  • image2
  • image3
  • image4
  • api_config
  • video
  • video_url
  • task_id
  • response
modelkling-v3.0-std-t2v
prompt
seconds5
ratio16:9
negative_prompt
skip_errorfalse
seed0

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 - adaptive or 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-r2v and kling-o3-pro-r2v fail at submit with an upstream 502 - only kling-o3-4k-r2v has 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-advanced and 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.

CategorySeedance

Inputs (12)

NameTypeDefaultDescription
modelCOMBOkling-v3.0-std-t2vKling task type. t2v uses prompt; i2v uses image1 and optional image2; o3-r2v uses up to 4 images. | Kling 任务类型:文生、图生/首尾帧、O3 参考生视频。
promptSTRINGText prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。
secondsCOMBO5Kling supports 5 or 10 seconds. | Kling 支持 5 或 10 秒。
ratioCOMBO16:9Aspect ratio forwarded as metadata.ratio when not adaptive. | 非 adaptive 时透传为 metadata.ratio。
negative_promptSTRINGOptional negative prompt forwarded to metadata. | 可选反向提示词,透传到 metadata。
image1optIMAGEOptional 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 按已连接图片顺序提交。
image2optIMAGEOptional 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 按已连接图片顺序提交。
image3optIMAGEOptional 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 按已连接图片顺序提交。
image4optIMAGEOptional 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_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