Seedance 2.0 ComfyUI Nodes

June 2, 2026 · View on GitHub

ComfyUI custom nodes for Seedance 2.0 — the state-of-the-art video generation model by ByteDance. Generate stunning AI videos directly inside ComfyUI using the muapi.ai API. If you wish to check the api documentation check this Seedance 2.0 api

License: MIT ComfyUI Seedance 2.0


What is Seedance 2.0?

Seedance 2.0 is ByteDance's latest video generation model, capable of producing high-quality, photorealistic videos from text prompts or reference images. It supports:

  • Text-to-Video — generate video from a text description
  • Image-to-Video — animate up to 9 reference images with motion guidance
  • Omni Reference — combine images, video clips, and audio as multi-modal reference inputs
  • Video Extend — seamlessly extend any generated video
  • Consistent Character — generate a 4K multi-panel character sheet from reference photos; use @character:<id> inline in any prompt, or wire the sheet image directly into Consistent Character Video for tighter face fidelity

Nodes

NodeDescription
🔑 Seedance 2.0 API KeySet your key once — wire to all nodes
🌱 Seedance 2.0 Text-to-VideoGenerate video from a text prompt
🌱 Seedance 2.0 Image-to-VideoAnimate up to 9 reference images
🌱 Seedance 2.0 Omni ReferenceMulti-modal: combine images, video clips, and audio
🌱 Seedance 2.0 Consistent CharacterGenerate a 4K character sheet from 1–3 reference photos
🌱 Seedance 2.0 Consistent Character VideoAnimate a scene with locked character identity from a sheet
🌱 Seedance 2.0 ExtendExtend a previously generated video
🌱 Seedance 2.0 Save VideoDownload URL → disk + ComfyUI IMAGE frames

Installation

  1. Open ComfyUI ManagerInstall via Git URL
  2. Paste: https://github.com/Anil-matcha/seedance2-comfyui
  3. Restart ComfyUI

Manual

cd ComfyUI/custom_nodes
git clone https://github.com/Anil-matcha/seedance2-comfyui
pip install -r seedance2-comfyui/requirements.txt

Quick Start

  1. Sign up at muapi.ai and go to Dashboard → API Keys → Create Key
  2. Right-click the ComfyUI canvas → Add Node🌱 Seedance 2.0
  3. Add a 🔑 Seedance 2.0 API Key node, paste your key, and wire its output to any generation node
  4. Write a prompt and hit Queue Prompt

Tip: If you use the MuAPI CLI, run muapi auth configure --api-key YOUR_KEY once and all nodes will pick it up automatically — no need to paste the key anywhere.


Node Reference

🔑 Seedance 2.0 API Key

Set your muapi.ai API key once and wire the output to all generation nodes. Alternatively, leave every api_key field blank — nodes automatically read from ~/.muapi/config.json if you've authenticated via the CLI.


🌱 Seedance 2.0 Text-to-Video

Generate a video from a text description.

FieldValuesDefault
api_keyOptional — leave blank if using the API Key node or CLI config
promptText describing the video
aspect_ratio16:9 / 9:16 / 4:3 / 3:416:9
qualitybasic / highbasic
duration5 / 10 / 15 seconds5

Outputs: video_url · first_frame (IMAGE) · request_id


🌱 Seedance 2.0 Image-to-Video

Animate reference images into a video. Connect up to 9 images via image_1image_9 and reference them in the prompt using @image1@image9.

Example prompt:

The cat in @image1 walks gracefully through a sunlit garden.
@image1 transforms into @image2 with a smooth dissolve transition.

🌱 Seedance 2.0 Omni Reference

Multi-modal video generation that combines images, video clips, and audio clips as reference material alongside a text prompt. Use @image1@image9, @video1@video3, and @audio1@audio3 to reference media in the prompt.

Example prompt:

A person @image1 walking on the beach at sunset, cinematic lighting, with @audio1 as background music.
FieldValuesDefault
promptText with optional @imageN, @videoN, @audioN references
aspect_ratio21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:1616:9
duration4 – 15 seconds (integer)5
image_1image_9Optional — ComfyUI IMAGE tensors (auto-uploaded)
video_url_1video_url_3Optional — MP4 URL (max 15s each)
audio_url_1audio_url_3Optional — MP3/WAV URL (total max 15s)

Outputs: video_url · first_frame (IMAGE) · request_id


🌱 Seedance 2.0 Consistent Character

Generate a 4K / 21:9 multi-panel character sheet (front, back, side profile, action pose, facial expressions, accessories) from 1–3 reference photos of a real person.

FieldDescription
image_1image_3Reference photos of the person (at least 1 required; clear frontal/3-4 angle shots work best)
outfit_descriptionDescribe the desired outfit/style for the character

Outputs:

OutputTypeDescription
sheet_imageIMAGECharacter sheet as a ComfyUI tensor — wire directly into Consistent Character Video
sheet_urlSTRINGCDN URL of the character sheet image
character_idSTRINGrequest_id of this generation — use as @character:<id> in T2V/I2V/Omni prompts

Recommended workflow — wire sheet_image into Consistent Character Video:

[LoadImage] ──→ [🌱 Consistent Character] ──(sheet_image)──→ [🌱 Consistent Character Video]
                    [outfit_description]       (sheet_url)          [scene prompt]

Alternative — use @character:<id> in any prompt (simpler but looser face fidelity):

[🌱 Consistent Character] character_id ──→ (paste into prompt) ──→ [🌱 Text-to-Video]

T2V prompt: "@character:{character_id} rides a motorcycle through a neon-lit city at night"

🌱 Seedance 2.0 Consistent Character Video

Generate a video scene with locked character identity. Anchors on the character sheet image as @image1 for maximum face/identity preservation.

Connect sheet_image (or paste sheet_url) from the Consistent Character node.

FieldDescription
promptScene description. @image1 refers to the character sheet and is auto-prepended if omitted.
sheet_imageIMAGE tensor from Consistent Character (preferred)
sheet_urlPaste the sheet URL if you don't have the tensor
scene_image_2, scene_image_3Optional extra scene/background images (referenced as @image2, @image3)
aspect_ratio16:9 / 9:16 / 4:3 / 3:4
qualitybasic / high
duration5 / 10 / 15 seconds

Outputs: video_url · first_frame (IMAGE) · request_id

Example prompt:

@image1 walks through a rain-soaked neon city, cinematic slow motion

🌱 Seedance 2.0 Extend

Continue any completed Seedance 2.0 video. Connect the request_id output from a generation node.

FieldDescription
request_idFrom a completed T2V or I2V generation
promptOptional — guide the continuation
qualitybasic / high
duration5 / 10 / 15 seconds to add

🌱 Seedance 2.0 Save Video

Downloads the generated video to ComfyUI's output folder and returns all frames as an IMAGE tensor for use with other nodes (preview, VHS, upscale, etc.).


Example Workflows

Load any .json file from this repo via File → Load in ComfyUI.

FileDescription
Seedance2_T2V_Example.jsonBasic text-to-video generation
Seedance2_ConsistentCharacter_Example.jsonFull consistent character workflow: reference photo → character sheet → video

Text-to-Video:

[🔑 API Key] ──────────────────────────────────┐

[🌱 Text-to-Video] → video_url → [🌱 Save Video] → frames → [Preview Image]

Consistent Character:

[🔑 API Key] ─────────────────────────────────────────────────────────────┐

[LoadImage] → [🌱 Consistent Character] → sheet_image → [🌱 Consistent Character Video] → [🌱 Save Video]
               [outfit_description]          ↓               [scene prompt]
                                    [Preview Image]                ↓
                                    (character sheet)      [Preview Image]
                                                           (first frame)

API

This node pack uses the muapi.ai API under the hood:

  • T2V: POST https://api.muapi.ai/api/v1/seedance-v2.0-t2v
  • I2V: POST https://api.muapi.ai/api/v1/seedance-v2.0-i2v
  • Omni: POST https://api.muapi.ai/api/v1/seedance-2.0-omni-reference
  • Character: POST https://api.muapi.ai/api/v1/seedance-2-character
  • Extend: POST https://api.muapi.ai/api/v1/seedance-v2.0-extend
  • Poll: GET https://api.muapi.ai/api/v1/predictions/{id}/result
  • Upload: POST https://api.muapi.ai/api/v1/upload_file

Authentication is a single x-api-key header — no session tokens required.


Requirements

  • Python ≥ 3.8
  • requests ≥ 2.28 · Pillow ≥ 9.0 · numpy ≥ 1.23 · torch ≥ 2.0 · opencv-python ≥ 4.7

Want More Models?

This repo is focused on Seedance 2.0 only. If you need access to 100+ models — Kling, Veo3, Flux, HiDream, GPT-image-1.5, Imagen4, Wan, lipsync, audio, image enhancement and more — check out the full MuAPI ComfyUI node pack:

SamurAIGPT/muapi-comfyui — ComfyUI nodes for every muapi.ai model in one place.


License

MIT © 2026