Files
gateway-ComfyUI-Kie-API/web/docs/KIE_Seedance2_Video.md

3.0 KiB

KIE Seedance 2.0 (Video)

Generate Seedance 2.0 videos with the verified bytedance/seedance-2 model.

Status: Experimental development pass. Credit Warning: Seedance 2.0 can take several minutes per job. Use KIE Seedance 2.0 Preflight first.

Inputs

  • prompt (STRING, required): main prompt text.
  • first_frame (IMAGE, optional): single first frame image.
  • last_frame (IMAGE, optional): single last frame image. Requires first_frame.
  • reference_images (IMAGE, optional): one or more reference images for multimodal reference mode.
  • reference_video (VIDEO, optional): one reference video for multimodal reference mode.
  • reference_audio (AUDIO, optional): one reference audio input for multimodal reference mode.
  • generate_audio (BOOLEAN, optional): asks KIE to generate audio.
  • return_last_frame (BOOLEAN, optional): asks KIE to include a last-frame artifact when supported.
  • aspect_ratio (COMBO, optional): 16:9, 9:16, 1:1.
  • resolution (COMBO, optional): 480p, 720p, 1080p.
  • duration (COMBO, optional): 5, 10, 15.
  • web_search (BOOLEAN, optional): forwards KIE's web-search toggle.
  • seedance_data (KIE_SEEDANCE2_REQUEST, optional): validated payload from preflight. When connected, this overrides direct field inputs.
  • log (BOOLEAN, optional): enable helper logging.

Scenario Rules

  • Text-to-video: Connect no media inputs.
  • First-frame image-to-video: Connect first_frame only.
  • First+last-frame image-to-video: Connect first_frame and last_frame.
  • Multimodal reference-to-video: Connect any mix of reference_images, reference_video, and reference_audio.
  • Hybrid control mode: You can combine first_frame and last_frame with reference media in the same request.
  • last_frame still requires first_frame.

Notes

  • The current aspect_ratio, resolution, and duration option lists are pinned to the public KIE examples used for this implementation pass. Widen them only after Windows-side live API verification confirms the accepted enum set.
  • Preflight now reports the exact payload fields present plus inferred alias order such as @Image1, @Video1, and @Audio1. Those aliases are treated as a likely model convention based on upload order, not a verified API contract.
  • The official KIE docs currently show a typo with reference_video_urls including a trailing space in the example payload. This node normalizes that field when consuming prebuilt payloads.
  • KIE's public marketing copy mentions optional lens locking, but the visible request example does not expose a verified request field for it yet. This first pass intentionally leaves that transport field out rather than guessing.
  • The official Seedance 2.0 Fast page is currently inconsistent and still shows model: "bytedance/seedance-2". This node intentionally targets only the verified non-fast model for now.
  • If KIE returns multiple artifacts, the node selects the video URL and ignores extra artifacts in the ComfyUI output contract.

Output

  • video (VIDEO): SaveVideo-compatible ComfyUI video output.