Seedance 2.0 API: Python Wrapper for ByteDance's AI Video Generator

The most comprehensive Python wrapper for the Seedance 2.0 API (developed by ByteDance), delivered via muapi.ai. Generate cinematic, high-fidelity AI videos from text prompts and static images with the world's most advanced video generation model.

Here is a comprehensive guide on using Seedance 2.0 API https://medium.com/@anilmatcha/seedance-2-0-api-complete-developer-guide-text-to-video-image-to-video-python-sdk-1479f5e5491f

🚀 Why Use Seedance 2.0 API?

Seedance 2.0 is the industry-leading Sora alternative developed by ByteDance, offering unparalleled video quality and motion consistency.

• Cinematic Quality: Generate 2K resolution AI videos with realistic physics and lighting.
• Superior Motion Control: Advanced camera movement and character consistency for professional results.
• Multimodal API: Supports Text-to-Video (T2V), Image-to-Video (I2V), and Video Extension.
• Developer-First: Fast processing via the MuAPI infrastructure with a simple Python SDK.

🌟 Key Features of Seedance 2.0 API

• ✅ Seedance 2.0 Text-to-Video (T2V): Transform complex descriptive prompts into stunning AI video clips.
• ✅ Seedance 2.0 Image-to-Video (I2V): Animate any static image with precise motion control using images_list.
• ✅ Seedance 2.0 Omni-Reference: Condition a video on any combination of image, video, and audio references in one request.
• ✅ Seedance 2.0 Character: Generate a reusable fictional character sheet from reference photos and reference it inline in any prompt.
• ✅ Seedance 2.0 Video-Edit: Edit existing videos using text prompts and reference images for stylized results.
• ✅ Video Extension: Seamlessly extend existing clips while maintaining consistent style and characters.
• ✅ High-Resolution Output: Support for basic and high (2K) quality settings.
• ✅ Flexible Aspect Ratios: Optimized for 16:9, 9:16 (TikTok/Reels), 4:3, and 3:4.

---

🛠 Installation

# Clone the Seedance 2.0 API repository
git clone https://github.com/Anil-matcha/Seedance-2.0-API.git
cd Seedance-2.0-API

# Install required dependencies
pip install -r requirements.txt

Configuration

Create a .env file in the root directory and add your MuAPI API key:

MUAPI_API_KEY=your_muapi_api_key_here

---

💻 Quick Start with Seedance 2.0 API (Python)

from seedance_api import SeedanceAPI

# Initialize the Seedance 2.0 client
api = SeedanceAPI()

# 1. Generate Video from Text (T2V) using Seedance 2.0 API
print("Generating AI Video using Seedance 2.0...")
submission = api.text_to_video(
    prompt="A cinematic slow-motion shot of a cyberpunk city in the rain, neon lights reflecting on puddles, 8k resolution",
    aspect_ratio="16:9",
    duration=5,
    quality="high"
)

# 2. Wait for completion
result = api.wait_for_completion(submission['request_id'])
print(f"Success! View your Seedance 2.0 video here: {result['url']}")

---

📡 API Endpoints & Reference

1. Seedance 2.0 Text-to-Video (T2V)

Endpoint: POST https://api.muapi.ai/api/v1/seedance-v2.0-t2v

Supports @character:<id> inline in the prompt — see Character Workflow below.

curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-t2v" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "A majestic eagle soaring over the snow-capped Himalayas",
      "aspect_ratio": "16:9",
      "duration": 5,
      "quality": "high"
  }'

2. Seedance 2.0 Image-to-Video (I2V)

Endpoint: POST https://api.muapi.ai/api/v1/seedance-v2.0-i2v

Reference images with @image1, @image2, etc. in the prompt. Supports @character:<id> — characters are automatically appended to images_list.

curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-i2v" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "Make the clouds move slowly across the sky",
      "images_list": ["https://example.com/mountain.jpg"],
      "aspect_ratio": "16:9",
      "duration": 5,
      "quality": "basic"
  }'

3. Seedance 2.0 Omni-Reference

Endpoint: POST https://api.muapi.ai/api/v1/seedance-2.0-omni-reference

Condition a single video generation on any combination of image, video, and audio references. Use @character:<id> inline in the prompt to inject a character (see section below).

curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.0-omni-reference" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "A dramatic chase scene through a neon city",
      "aspect_ratio": "16:9",
      "duration": 5,
      "images_list": ["https://example.com/scene_ref.jpg"],
      "video_files": ["https://example.com/style_ref.mp4"]
  }'

4. Seedance 2.0 Character (Reusable Character Sheets)

Endpoint: POST https://api.muapi.ai/api/v1/seedance-2-character

Create a fictional character from real reference photos. Once the character sheet is generated you can reference it in any T2V, I2V, or Omni-Reference prompt using @character:<request_id>.

curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2-character" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "images_list": ["https://example.com/person.jpg"],
      "outfit_description": "cyberpunk jacket with neon accents",
      "character_name": "Nova"
  }'

5. Seedance 2.0 Video-Edit

Endpoint: POST https://api.muapi.ai/api/v1/seedance-v2.0-video-edit

curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-video-edit" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "The cat walks through a garden",
      "video_urls": ["https://example.com/video.mp4"],
      "images_list": ["https://example.com/image.jpg"],
      "aspect_ratio": "16:9",
      "quality": "basic",
      "remove_watermark": false
  }'

---

🎭 Character Workflow

Create a reusable fictional character from reference photos and inject it into any video prompt using @character:<id>.

from seedance_api import SeedanceAPI
api = SeedanceAPI()

# Step 1 — generate a character sheet
char = api.create_character(
    images_list=["https://example.com/person.jpg"],
    outfit_description="cyberpunk jacket with neon accents, glowing visor",
    character_name="Nova"
)
char_id = char["request_id"]
print(f"Character ID: {char_id}")
api.wait_for_completion(char_id)  # wait for sheet to render

# Step 2 — use the character in a T2V prompt
video = api.text_to_video(
    prompt=f"@character:{char_id} rides a motorcycle through a neon-lit city at night, cinematic",
    aspect_ratio="16:9",
    duration=5,
)
result = api.wait_for_completion(video["request_id"])
print(f"Video: {result['url']}")

# Multi-character example
char2_id = "another-completed-character-request-id"
video2 = api.text_to_video(
    prompt=f"@character:{char_id} and @character:{char2_id} face off in a neon-lit arena, dramatic camera angles",
    aspect_ratio="16:9",
    duration=5,
)

Tip: @character:<id> works in T2V, I2V, and Omni-Reference prompts. Multiple characters can be referenced in a single prompt.

---

📖 Documentation & Guides

For a comprehensive walkthrough, check out the Seedance 2.0 API: Complete Developer Guide on Medium. This guide covers advanced use cases, prompt engineering, and best practices for high-quality video generation.

Method	Parameters	Description
text_to_video	prompt, aspect_ratio, duration, quality	Generate video from text. Supports @character:<id> in prompt.
image_to_video	prompt, images_list, aspect_ratio, duration, quality	Animate images. Supports @image1/@character:<id> in prompt.
omni_reference	prompt, aspect_ratio, duration, images_list, video_files, audio_files	Multi-modal reference video generation.
create_character	images_list, outfit_description, character_name	Create a reusable fictional character sheet from reference photos.
video_edit	prompt, video_urls, images_list, aspect_ratio, quality, remove_watermark	Edit existing videos with prompts and images.
extend_video	request_id, prompt, duration, quality	Extend an existing Seedance video segment.
get_result	request_id	Check task status for the Seedance API.
wait_for_completion	request_id, poll_interval, timeout	Blocking helper for Seedance generation tasks.

---

🔗 Official Resources

• Developer Guide: Seedance 2.0 API: Complete Tutorial
• Playground: Seedance 2.0 I2V Playground
• Extension Tool: Seedance 2.0 Extend Playground
• API Provider: MuAPI.ai

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Keywords: Seedance 2.0 API, ByteDance Seedance, AI Video Generator, Text-to-Video AI, Image-to-Video API, Seedance Python SDK, Seedance V2 API, Sora Alternative, MuAPI, Video Generation API, Cinematic AI Video, AI Video Creation, ByteDance Video AI, Seedance API Documentation, Seedance I2V, Seedance T2V, AI Movie Generator, AI Animation API, Python Video API, Seedance 2.0 Tutorial.