Seedance 2.0, 2.5 & 2 Mini ComfyUI Nodes

Seedance 2.5 ComfyUI and Seedance 2.0 custom nodes — generate ByteDance Seedance videos directly inside ComfyUI through the muapi.ai API. This repository contains the Seedance 2.0 and Seedance 2 Mini nodes. For native Seedance 2.5 ComfyUI nodes, use the companion seedance2.5-comfyui pack. API documentation: Seedance 2 API · Seedance 2.5 API

---

Seedance 2.5 ComfyUI

Looking for Seedance 2.5 ComfyUI custom nodes, Seedance 2.5 workflows, or a Seedance 2.5 API integration for ComfyUI? Use the dedicated Seedance 2.5 ComfyUI repository.

The companion pack supports the current Seedance 2.5 workflow surface: 720p and 480p text-to-video, image-to-video, first/last-frame transitions, Omni Reference with image/video/audio inputs, spicy generation, consistent characters, video saving, and Seedance-family extension. It is the recommended installation for native Seedance 2.5 generation; this repository remains the stable Seedance 2.0 and Seedance 2 Mini integration.

Related Projects

• seedance2.5-comfyui — Native Seedance 2.5 ComfyUI custom nodes and example workflows

• Seedance-2.5-API — Python wrapper for the Seedance 2.5 API — text-to-video, image-to-video, character consistency

• seedance-2-generator — Ready-made Next.js SaaS built on Seedance 2 — no ComfyUI needed

• seedance-2.0-watermark-remover — Remove watermarks from your Seedance 2 outputs
• n8n-nodes-seedance2 — Automate Seedance 2 generation in n8n workflows
• muapi-comfyui — ComfyUI nodes for 100+ MuAPI models including Seedance
• awesome-seedance-2.5-api-prompts — Curated Seedance 2.5 API guide, prompts, camera controls, and video generation examples
• seedance-2-mcp — Focused MCP server for Seedance 2 generation from AI assistants
• seedance-2.5-mcp — Focused MCP server for Seedance 2.5 Preview generation

🧪 Try in the Muapi Playground (no ComfyUI needed)

Model	Image-to-Video	Text-to-Video
Seedance 2.0 Mini (coming soon)	Playground	Playground
Seedance 2.1 (coming soon)	Playground	Playground
Seedance 2.5	Playground	Playground

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
• Seedance 2 Mini — ByteDance's lightweight model for fast, affordable generation at ~$0.073/sec; ideal for rapid iteration and high-volume workflows

---

Nodes

Node	Description
🔑 Seedance 2.0 API Key	Set your key once — wire to all nodes
🌱 Seedance 2.0 Text-to-Video	Generate video from a text prompt
🌱 Seedance 2.0 Image-to-Video	Animate up to 9 reference images
🌱 Seedance 2.0 Omni Reference	Multi-modal: combine images, video clips, and audio
🌱 Seedance 2.0 Consistent Character	Generate a 4K character sheet from 1–3 reference photos
🌱 Seedance 2.0 Consistent Character Video	Animate a scene with locked character identity from a sheet
🌱 Seedance 2.0 Extend	Extend a previously generated video
🌱 Seedance 2.0 Save Video	Download URL → disk + ComfyUI IMAGE frames
⚡ Seedance 2 Mini Text-to-Video	Fast, affordable T2V at ~$0.073/sec — great for rapid iteration
⚡ Seedance 2 Mini Image-to-Video	Fast, affordable I2V — ideal for bulk ComfyUI workflows

---

Installation

Via ComfyUI Manager (recommended)

1. Open ComfyUI Manager → Install 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.

Seedance 2.5: Install the Seedance 2.5 ComfyUI pack for native 2.5 nodes. It uses the Seedance 2.5 API and has separate 720p/480p controls.

---

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.

Field	Values	Default
api_key	Optional — leave blank if using the API Key node or CLI config	—
prompt	Text describing the video	—
aspect_ratio	16:9 / 9:16 / 4:3 / 3:4	16:9
quality	basic / high	basic
duration	5 / 10 / 15 seconds	5

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_1 … image_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.

Field	Values	Default
prompt	Text with optional @imageN, @videoN, @audioN references	—
aspect_ratio	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16	16:9
duration	4 – 15 seconds (integer)	5
image_1 … image_9	Optional — ComfyUI IMAGE tensors (auto-uploaded)	—
video_url_1 … video_url_3	Optional — MP4 URL (max 15s each)	—
audio_url_1 … audio_url_3	Optional — 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.

Field	Description
image_1 … image_3	Reference photos of the person (at least 1 required; clear frontal/3-4 angle shots work best)
outfit_description	Describe the desired outfit/style for the character

Outputs:

Output	Type	Description
sheet_image	IMAGE	Character sheet as a ComfyUI tensor — wire directly into Consistent Character Video
sheet_url	STRING	CDN URL of the character sheet image
character_id	STRING	request_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.

Field	Description
prompt	Scene description. @image1 refers to the character sheet and is auto-prepended if omitted.
sheet_image	IMAGE tensor from Consistent Character (preferred)
sheet_url	Paste the sheet URL if you don't have the tensor
scene_image_2, scene_image_3	Optional extra scene/background images (referenced as @image2, @image3)
aspect_ratio	16:9 / 9:16 / 4:3 / 3:4
quality	basic / high
duration	5 / 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.

Field	Description
request_id	From a completed T2V or I2V generation
prompt	Optional — guide the continuation
quality	basic / high
duration	5 / 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.

File	Description
Seedance2_T2V_Example.json	Basic text-to-video generation
Seedance2_ConsistentCharacter_Example.json	Full 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)

---

Seedance 2.5 API and ComfyUI integration

Seedance 2.5 is the newer Seedance video API with dedicated 720p and 480p tiers, longer clips, first/last-frame transitions, and expanded Omni Reference inputs. The native ComfyUI implementation lives in Anil-matcha/seedance2.5-comfyui; this page remains the compatibility and workflow hub for Seedance 2.0, Seedance 2 Mini, and related MuAPI integrations.

For the API contract, endpoint list, and Python wrapper, see SamurAIGPT/Seedance-2.5-API.

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://