Skip to content
Back to search

Seedance-2-API

Python wrapper for ByteDance's Seedance 2.0 , Seedance 2.5 and Seedance 2 Mini API — Text-to-Video, Image-to-Video, realistic human faces, 1080p, consistent character generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Anil-matcha/Seedance-2-API with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Anil-matcha/Seedance-2-API'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anil-matcha--seedance-2-api/badge.svg)](/listings/anil-matcha--seedance-2-api)

HTML

<a href="/listings/anil-matcha--seedance-2-api"><img src="/api/listings/anil-matcha--seedance-2-api/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Via Pip (Recommended)

pip install seedance-2-api

From Source

# 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
```stall -r requirements.txt

Configuration

Create a `.env` file in the root directory and add your [MuAPI](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) API key:

MUAPI_API_KEY=your_muapi_api_key_here

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 423 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Seedance 2.0, Seedance 2.5, Seedance 2.5 Flash & Seedance 2 Mini API: Python Wrapper for ByteDance's AI Video Generator
  2. [![Powered by MuAPI](https://img.shields.io/badge/Powered%20by-MuAPI-6366f1?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyem0tMSAxNHYtNGgtMnYtMmg0djZoLTJ6bTAtOFY2aDJ2MmgtMnoiLz48L3N2Zz4=)](https://muapi.ai?utm_source=github&utm_medium=badge&utm_campaign=seedance-2-api)
  3. [![PyPI version](https://img.shields.io/pypi/v/seedance-2-api.svg)](https://pypi.org/project/seedance-2-api/)
  4. [![GitHub stars](https://img.shields.io/github/stars/Anil-matcha/Seedance-2.0-API.svg)](https://github.com/Anil-matcha/Seedance-2.0-API/stargazers)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
  7. The most comprehensive Python wrapper for the **Seedance 2.0 API** , **Seedance 2.5 API** **Seedance 2 Mini API** (developed by ByteDance), delivered via [muapi.ai](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api). Generate cinematic, high-fidelity AI videos from text prompts and static images — with industry-leading **realistic human face generation** — using the world's most advanced video generation model. Use Seedance 2.0 for maximum quality or **Seedance 2 Mini** for fast, affordable generation at a fraction of the cost.
  8. Join the subreddit https://www.reddit.com/r/Seedance_2_API/ for discussions on using Seedance 2 api
  9. 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
  10. > ✅ **Now Available: Seedance 2 Mini** — ByteDance's new lightweight model that outperforms Seedance 2.0 Fast at a fraction of the cost (pricing as low as ~$0.073/sec). Use `text_to_video_mini()` / `image_to_video_mini()` in the SDK, or hit the `/seedance-2-mini-t2v` and `/seedance-2-mini-i2v` endpoints directly. Discuss on [r/Seedance_2_API](https://www.reddit.com/r/Seedance_2_API/).
  11. > - 🧪 Try **Seedance 2.0 Mini** now: [Image-to-Video Playground](https://muapi.ai/playground/seedance-2.0-mini-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [Text-to-Video Playground](https://muapi.ai/playground/seedance-2.0-mini-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  12. > - 🚀 **Seedance 2.1** (~20% quality lift, 1080p, native audio) coming soon: [I2V Playground](https://muapi.ai/playground/seedance-2.1-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [T2V Playground](https://muapi.ai/playground/seedance-2.1-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  13. > - 🌟 **Seedance 2.5** (native 4K, 30s clips, native audio, 30 images/10 videos/10 audio references) is **live now**: [I2V Playground](https://muapi.ai/playground/seedance-2.5-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [T2V Playground](https://muapi.ai/playground/seedance-2.5-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [📺 Video Tutorial](https://www.youtube.com/watch?v=Uszlw7H4VP4)
  14. > 🌊 **Also explore these top AI video models:**
  15. > - 🐎 [HappyHorse 1.0 API](https://github.com/Anil-matcha/HappyHorse-1.0-API) — Alibaba's #1 ranked model (1392 Elo I2V) with native 1080p & integrated audio
  16. > - 🎬 [Veo 4 API](https://github.com/Anil-matcha/Veo-4-API) — Google DeepMind's native 4K model with audio, character consistency & camera controls
  17. ## 📺 Video Tutorial
  18. [![How to Access Seedance 2.5 API (Step-by-Step Guide)](https://img.youtube.com/vi/Uszlw7H4VP4/maxresdefault.jpg)](https://www.youtube.com/watch?v=Uszlw7H4VP4)
  19. **[How to Access Seedance 2.5 API (Step-by-Step Guide)](https://www.youtube.com/watch?v=Uszlw7H4VP4)** — a full walkthrough of getting an API key and making your first Seedance 2.5 call via [MuAPI](https://muapi.ai/seedance-2.5?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api).
  20. ## Related Projects
  21. - [Seedance-2-Spicy-API](https://github.com/Anil-matcha/Seedance-2-Spicy-API) — Python SDK and MCP server for the relaxed-moderation Seedance 2 Spicy / 2 Mini Spicy tier.
  22. - [Seedance-2.5-Spicy-API](https://github.com/Anil-matcha/Seedance-2.5-Spicy-API) — Python SDK and MCP server for the relaxed-moderation Seedance 2.5 Spicy tier.
  23. - [MiniMax-H3-API](https://github.com/Anil-matcha/MiniMax-H3-API) — Python SDK for MiniMax H3 text-to-video, image-to-video, and first/last-frame video generation.
  24. - [Wan-3.0-API](https://github.com/Anil-matcha/Wan-3.0-API) — Python SDK and MCP server for Wan 3.0-compatible text-to-video, image-to-video, and reference-to-video workflows.
  25. - [Seedance-2.5-API](https://github.com/SamurAIGPT/Seedance-2.5-API) — Python wrapper for the Seedance 2.5 API — text-to-video, image-to-video, character consistency
  26. - [Seedance-3-API](https://github.com/Anil-matcha/Seedance-3-API) — companion project for the next Seedance API generation on MuAPI.
  27. - [awesome-seedance-3-api-prompts](https://github.com/SamurAIGPT/awesome-seedance-3-api-prompts) — Seedance 3 prompt library and integration status.
  28. - [seedance-2-mcp](https://github.com/Anil-matcha/seedance-2-mcp) — Focused MCP server for Seedance 2 from Claude, Cursor, and other AI assistants
  29. - [seedance-2.5-mcp](https://github.com/Anil-matcha/seedance-2.5-mcp) — Focused MCP server for Seedance 2.5 Preview with 720p/480p route selection
  30. - [seedance-2.0-watermark-remover](https://github.com/SamurAIGPT/seedance-2.0-watermark-remover) — Remove watermarks from your Seedance 2 generated videos
  31. - [seedance-2-generator](https://github.com/SamurAIGPT/seedance-2-generator) — Ready-made Next.js SaaS built on Seedance 2
  32. - [seedance2-comfyui](https://github.com/Anil-matcha/seedance2-comfyui) — Run Seedance 2 inside ComfyUI
  33. - [seedance2.5-comfyui](https://github.com/Anil-matcha/seedance2.5-comfyui) — Native Seedance 2.5 ComfyUI custom nodes and example workflows
  34. - [n8n-nodes-seedance2](https://github.com/Anil-matcha/n8n-nodes-seedance2) — Automate Seedance 2 in n8n workflows
  35. - [awesome-seedance-2.5-api-prompts](https://github.com/Anil-matcha/awesome-seedance-2.5-api-prompts) — Curated Seedance 2.5 API guide, prompts, camera controls, and video generation examples
  36. - [awesome-seedance-motion-control-api](https://github.com/Anil-matcha/awesome-seedance-motion-control-api) — Seedance 2 & 2.5 Motion Control API guide — recast a performance video with new performers while preserving motion, camera, and location
  37. - [Awesome Claude Fable 5](https://github.com/Anil-matcha/awesome-claude-fable-5) — Curated real-world use cases, tutorials, and benchmarks for Claude Fable 5 — access exclusively via MuAPI
  38. - [Flux-3-Dev-API](https://github.com/Anil-matcha/Flux-3-Dev-API) — Python wrapper for Black Forest Labs' FLUX 3 (Dev variant) — text-to-image, image-to-image, text-to-video, image-to-video
  39. - [awesome-flux-3-api-prompts](https://github.com/Anil-matcha/awesome-flux-3-api-prompts) — FLUX 3 API guide, prompts, and parameters
  40. ## Seedance 2.5 Flash API
  41. Dreamina Seedance 2.5 Flash is ByteDance's faster Seedance 2.5 tier: results close to flagship Seedance 2.5 with nearly twice the generation speed. [BytePlus announced](https://x.com/BytePlusGlobal/status/2120760891344036304) 720p text-to-video and image-to-video pricing of USD 0.152 per second (about 34% lower than Seedance 2.5) and a ModelArk API launch on November 15, 2026.
  42. Muapi's Seedance 2.5 Flash API page covers it: **[muapi.ai/seedance-2.5-flash](https://muapi.ai/seedance-2.5-flash?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)**. Eighteen Seedance 2.5 Flash endpoints are available through one Muapi key (standard, international `seedance-2.5-flash-intl-*` and spicy `seedance-2.5-flash-spicy-*`, each with text-to-video, image-to-video, first-last-frame, reference-to-video, video-edit and video-extend), and the flagship Seedance 2.5 endpoints below use the same submit-and-poll flow.
  43. ## 🚀 Why Use Seedance 2.0 API?
  44. Seedance 2.0 is the industry-leading **Sora alternative** developed by ByteDance, offering unparalleled video quality and motion consistency.
  45. - **Cinematic Quality**: Generate 1080p AI videos with realistic physics and lighting.
  46. - **Realistic Human Faces**: Best-in-class facial fidelity — natural expressions, skin detail, and identity consistency across frames.
  47. - **Less Censorship**: More permissive content policy compared to other AI video models, enabling a wider range of creative use cases.
  48. - **Superior Motion Control**: Advanced camera movement and character consistency for professional results.
  49. - **Multimodal API**: Supports Text-to-Video (T2V), Image-to-Video (I2V), and Video Extension.
  50. - **Seedance 2 Mini**: ByteDance's newest lightweight model — outperforms Seedance 2.0 Fast at ~$0.073/sec with dramatically lower cost. Ideal for prototyping, high-volume pipelines, and latency-sensitive apps.
  51. - **Developer-First**: Fast processing via the MuAPI infrastructure with a simple Python SDK.
  52. ## 🌟 Key Features of Seedance 2.0 API
  53. - ✅ **Realistic Human Face Generation**: Produces natural, high-fidelity human faces with accurate expressions, skin texture, and identity consistency — no uncanny valley.
  54. - ✅ **Seedance 2.0 Text-to-Video (T2V)**: Transform complex descriptive prompts into stunning AI video clips.
  55. - ✅ **Seedance 2.0 Image-to-Video (I2V)**: Animate any static image with precise motion control using `images_list`.
  56. - ✅ **Seedance 2.0 Omni-Reference**: Condition a video on any combination of image, video, and audio references in one request.
  57. - ✅ **Seedance 2.0 Character**: Generate a multi-panel character sheet (front, back, side, action pose, expressions) from 1–3 reference photos. Use `@character:<id>` inline in any prompt, or pass the sheet directly as an anchor image for tighter face fidelity via `consistent_video()`.
  58. - ✅ **Seedance 2.0 Video-Edit**: Edit existing videos using text prompts and reference images for stylized results.
  59. - ✅ **File Upload**: Directly upload local images and videos using the `upload_file` method, supporting seamless use in generation tasks.
  60. - ✅ **Seedance 2 Mini Text-to-Video**: Fast, affordable T2V using `text_to_video_mini()` — outperforms Seedance 2.0 Fast at ~$0.073/sec.
  61. - ✅ **Seedance 2 Mini Image-to-Video**: Animate images quickly and cheaply using `image_to_video_mini()` — great for high-volume workflows.
  62. - ✅ **Seedance 2 VIP 1080p Text-to-Video**: Generate full 1080p videos from text with VIP priority queue and low censorship. *(Coming Soon)*
  63. - ✅ **Seedance 2 VIP 1080p Image-to-Video**: Animate images to full 1080p with VIP priority queue and low censorship. *(Coming Soon)*
  64. - ✅ **Video Extension**: Seamlessly extend existing clips while maintaining consistent style and characters.
  65. - ✅ **High-Resolution Output**: Support for `basic` and `high` (1080p) quality settings.
  66. - ✅ **Less Censorship**: More permissive content policy than competing models — broader creative freedom out of the box.
  67. - ✅ **Flexible Aspect Ratios**: Optimized for `16:9`, `9:16` (TikTok/Reels), `4:3`, and `3:4`.
  68. ---
  69. ## 🛠 Installation
  70. ### Via Pip (Recommended)
  71. ```bash
  72. pip install seedance-2-api
  73. ```
  74. ### From Source
  75. ```bash
  76. # Clone the Seedance 2.0 API repository
  77. git clone https://github.com/Anil-matcha/Seedance-2.0-API.git
  78. cd Seedance-2.0-API
  79. # Install required dependencies
  80. pip install -r requirements.txt
  81. ```stall -r requirements.txt
  82. ```
  83. ### Configuration
  84. Create a `.env` file in the root directory and add your [MuAPI](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) API key:
  85. ```env
  86. MUAPI_API_KEY=your_muapi_api_key_here
  87. ```
  88. ---
  89. ## 🤖 Seedance 2.0 MCP Server (New!)
  90. You can now use Seedance 2.0 as an **MCP (Model Context Protocol)** server. This allows AI models (like Claude Desktop or Cursor) to directly invoke Seedance tools.
  91. ### Running the MCP Server
  92. 1. Ensure `MUAPI_API_KEY` is set in your environment.
  93. 2. Run the server:
  94. ```bash
  95. python3 mcp_server.py
  96. ```
  97. 3. To test with the MCP Inspector:
  98. ```bash
  99. npx -y @modelcontextprotocol/inspector python3 mcp_server.py
  100. ```
  101. ---
  102. ## 💻 Quick Start with Seedance 2.0 API (Python)
  103. ```python
  104. from seedance_api import SeedanceAPI
  105. # Initialize the Seedance 2.0 client
  106. api = SeedanceAPI()
  107. # 1. Generate Video from Text (T2V) using Seedance 2.0 API
  108. print("Generating AI Video using Seedance 2.0...")
  109. submission = api.text_to_video(
  110. prompt="A cinematic slow-motion shot of a cyberpunk city in the rain, neon lights reflecting on puddles, 8k resolution",
  111. aspect_ratio="16:9",
  112. duration=5,
  113. quality="high"
  114. )
  115. # 2. Wait for completion
  116. result = api.wait_for_completion(submission['request_id'])
  117. print(f"Success! View your Seedance 2.0 video here: {result['url']}")
  118. ```
  119. ---
  120. ## 📡 API Endpoints & Reference
  121. ### 1. Seedance 2.0 Text-to-Video (T2V)
  122. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-v2.0-t2v`
  123. Supports `@character:<id>` inline in the prompt — see [Character Workflow](#-character-workflow) below.
  124. ```bash
  125. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-t2v" \
  126. --header "Content-Type: application/json" \
  127. --header "x-api-key: YOUR_API_KEY" \
  128. --data-raw '{
  129. "prompt": "A majestic eagle soaring over the snow-capped Himalayas",
  130. "aspect_ratio": "16:9",
  131. "duration": 5,
  132. "quality": "high"
  133. }'
  134. ```
  135. ### 2. Seedance 2.0 Image-to-Video (I2V)
  136. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-v2.0-i2v`
  137. Reference images with `@image1`, `@image2`, etc. in the prompt. Supports `@character:<id>` — characters are automatically appended to `images_list`.
  138. ```bash
  139. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-i2v" \
  140. --header "Content-Type: application/json" \
  141. --header "x-api-key: YOUR_API_KEY" \
  142. --data-raw '{
  143. "prompt": "Make the clouds move slowly across the sky",
  144. "images_list": ["https://example.com/mountain.jpg"],
  145. "aspect_ratio": "16:9",
  146. "duration": 5,
  147. "quality": "basic"
  148. }'
  149. ```
  150. ### 3. Seedance 2.0 Omni-Reference
  151. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-2.0-omni-reference`
  152. 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).
  153. ```bash
  154. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.0-omni-reference" \
  155. --header "Content-Type: application/json" \
  156. --header "x-api-key: YOUR_API_KEY" \
  157. --data-raw '{
  158. "prompt": "A dramatic chase scene through a neon city",
  159. "aspect_ratio": "16:9",
  160. "duration": 5,
  161. "images_list": ["https://example.com/scene_ref.jpg"],
  162. "video_files": ["https://example.com/style_ref.mp4"]
  163. }'
  164. ```
  165. ### 4. Seedance 2.0 Character (Consistent Character Sheets)
  166. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-2-character`
  167. Create a multi-panel character sheet (front, back, side profile, action pose, facial expressions, accessories) at 4K / 21:9 from 1–3 reference photos of a real person.
  168. Once the sheet is generated you can use it two ways:
  169. - **`@character:<request_id>`** inline in any T2V, I2V, or Omni-Reference prompt
  170. - Pass `outputs[0]` (the sheet image URL) directly as `@image1` in an I2V request for tighter face fidelity
  171. | Field | Type | Required | Description |
  172. |---|---|---|---|
  173. | `images_list` | array of URLs | Yes | 1–3 photos of the reference person |
  174. | `prompt` | string | Yes | Desired outfit/style for the character |
  175. ```bash
  176. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2-character" \
  177. --header "Content-Type: application/json" \
  178. --header "x-api-key: YOUR_API_KEY" \
  179. --data-raw '{
  180. "images_list": ["https://example.com/person.jpg"],
  181. "prompt": "cyberpunk jacket with neon accents"
  182. }'
  183. ```
  184. **Cost:** $0.18 per character sheet
  185. For a full guide including the direct sheet-anchored I2V workflow, see [CHARACTER_CONSISTENCY.md](CHARACTER_CONSISTENCY.md).
  186. ### 5. Seedance 2.0 Video-Edit
  187. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-v2.0-video-edit`
  188. ```bash
  189. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-v2.0-video-edit" \
  190. --header "Content-Type: application/json" \
  191. --header "x-api-key: YOUR_API_KEY" \
  192. --data-raw '{
  193. "prompt": "The cat walks through a garden",
  194. "video_urls": ["https://example.com/video.mp4"],
  195. "images_list": ["https://example.com/image.jpg"],
  196. "aspect_ratio": "16:9",
  197. "quality": "basic",
  198. "remove_watermark": false
  199. }'
  200. ```
  201. ### 6. Seedance 2 Mini Text-to-Video (T2V)
  202. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-2-mini-t2v`
  203. ByteDance's lightweight Seedance 2 Mini model — outperforms Seedance 2.0 Fast at a fraction of the cost (~$0.073/sec). Supports the same prompt format as Seedance 2.0.
  204. ```bash
  205. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2-mini-t2v" \
  206. --header "Content-Type: application/json" \
  207. --header "x-api-key: YOUR_API_KEY" \
  208. --data-raw '{
  209. "prompt": "A golden retriever running on a sunny beach, slow motion",
  210. "aspect_ratio": "16:9",
  211. "duration": 5
  212. }'
  213. ```
  214. **Python SDK:**
  215. ```python
  216. submission = api.text_to_video_mini(
  217. prompt="A golden retriever running on a sunny beach, slow motion",
  218. aspect_ratio="16:9",
  219. duration=5,
  220. )
  221. result = api.wait_for_completion(submission["request_id"])
  222. print(f"Seedance 2 Mini video: {result['outputs'][0]}")
  223. ```
  224. ### 7. Seedance 2 Mini Image-to-Video (I2V)
  225. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-2-mini-i2v`
  226. Animate any image using Seedance 2 Mini — fast, affordable, and ideal for high-volume pipelines.
  227. ```bash
  228. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2-mini-i2v" \
  229. --header "Content-Type: application/json" \
  230. --header "x-api-key: YOUR_API_KEY" \
  231. --data-raw '{
  232. "prompt": "The waves crash gently onto the shore",
  233. "images_list": ["https://example.com/beach.jpg"],
  234. "aspect_ratio": "16:9",
  235. "duration": 5
  236. }'
  237. ```
  238. **Python SDK:**
  239. ```python
  240. submission = api.image_to_video_mini(
  241. prompt="The waves crash gently onto the shore",
  242. images_list=["https://example.com/beach.jpg"],
  243. aspect_ratio="16:9",
  244. duration=5,
  245. )
  246. result = api.wait_for_completion(submission["request_id"])
  247. print(f"Seedance 2 Mini video: {result['outputs'][0]}")
  248. ```
  249. ---
  250. ## 🎭 Character Consistency Workflow
  251. Create a fictional character from reference photos and maintain their identity across multiple video scenes.
  252. Two approaches are available — see [CHARACTER_CONSISTENCY.md](CHARACTER_CONSISTENCY.md) for a full guide.
  253. ### Option A — `@character:<id>` inline (simplest)
  254. ```python
  255. from seedance_api import SeedanceAPI
  256. api = SeedanceAPI()
  257. # Step 1 — generate a character sheet (1–3 reference photos)
  258. char = api.create_character(
  259. images_list=["https://example.com/person.jpg"],
  260. outfit_description="cyberpunk jacket with neon accents, glowing visor",
  261. )
  262. char_id = char["request_id"]
  263. api.wait_for_completion(char_id) # wait for sheet to render
  264. # Step 2 — reference the character inline in any prompt
  265. video = api.text_to_video(
  266. prompt=f"@character:{char_id} rides a motorcycle through a neon-lit city at night",
  267. aspect_ratio="16:9",
  268. duration=5,
  269. )
  270. result = api.wait_for_completion(video["request_id"])
  271. print(f"Video: {result['outputs'][0]}")
  272. # Multiple characters in one prompt
  273. char2_id = "another-completed-character-request-id"
  274. video2 = api.text_to_video(
  275. prompt=f"@character:{char_id} and @character:{char2_id} face off in a neon-lit arena",
  276. aspect_ratio="16:9",
  277. duration=5,
  278. )
  279. ```
  280. ### Option B — `consistent_video()` (tighter face fidelity)
  281. Pass the character sheet directly as the anchor image for Image-to-Video generation.
  282. ```python
  283. # Get the sheet URL after character creation
  284. sheet_result = api.wait_for_completion(char_id)
  285. sheet_url = sheet_result["outputs"][0]
  286. # Generate with the sheet as anchor
  287. video = api.consistent_video(
  288. sheet_url=sheet_url,
  289. prompt="@image1 draws their weapon in slow motion, dramatic lighting",
  290. aspect_ratio="16:9",
  291. duration=5,
  292. quality="high",
  293. )
  294. result = api.wait_for_completion(video["request_id"])
  295. print(f"Video: {result['outputs'][0]}")
  296. ```
  297. > **Tip**: `@character:<id>` works in T2V, I2V, and Omni-Reference prompts. Use `consistent_video()` when face similarity is critical.
  298. ---
  299. ## 📖 Documentation & Guides
  300. For a comprehensive walkthrough, check out the **[Seedance 2.0 API: Complete Developer Guide](https://medium.com/@anilmatcha/seedance-2-0-api-complete-developer-guide-text-to-video-image-to-video-python-sdk-1479f5e5491f)** on Medium. This guide covers advanced use cases, prompt engineering, and best practices for high-quality video generation.
  301. | Method | Parameters | Description |
  302. | :--- | :--- | :--- |
  303. | `text_to_video` | `prompt`, `aspect_ratio`, `duration`, `quality`, `remove_watermark` | Generate video from text. Supports `@character:<id>` in prompt. |
  304. | `image_to_video` | `prompt`, `images_list`, `aspect_ratio`, `duration`, `quality`, `remove_watermark` | Animate images. Supports `@image1`/`@character:<id>` in prompt. |
  305. | `omni_reference` | `prompt`, `aspect_ratio`, `duration`, `quality`, `images_list`, `video_files`, `audio_files` | Multi-modal reference video generation. |
  306. | `create_character` | `images_list` (1–3), `outfit_description`, `character_name` | Generate a 4K character sheet from reference photos. Returns `request_id`; `outputs[0]` is the sheet URL. |
  307. | `consistent_video` | `sheet_url`, `prompt`, `aspect_ratio`, `duration`, `quality`, `extra_images` | I2V with the character sheet as anchor (`@image1`). Tighter face fidelity than `@character:<id>`. |
  308. | `video_edit` | `prompt`, `video_urls`, `images_list`, `aspect_ratio`, `quality`, `remove_watermark` | Edit existing videos with prompts and images. |
  309. | `watermark_remover`| `video_url` | Remove MuAPI watermark from a Seedance video. |
  310. | `watermark_remover_pro`| `video_url` | Remove MuAPI watermark from a Seedance video (Pro version). |
  311. | `text_to_video_mini` | `prompt`, `aspect_ratio`, `duration` | **Seedance 2 Mini** T2V — outperforms 2.0 Fast at ~$0.073/sec. |
  312. | `image_to_video_mini` | `prompt`, `images_list`, `aspect_ratio`, `duration` | **Seedance 2 Mini** I2V — fast, affordable image animation. |
  313. | `text_to_video_480p`| `prompt`, `aspect_ratio`, `duration`, `quality` | Generate a 480p video from text (faster/cheaper). |
  314. | `image_to_video_480p`| `prompt`, `images_list`, `aspect_ratio`, `duration`, `quality` | Generate a 480p video from an image (faster/cheaper). |
  315. | `extend_video` | `request_id`, `prompt`, `duration`, `quality` | Extend an existing Seedance video segment. |
  316. | `upload_file` | `file_path` | Upload a local file (image or video) to MuAPI for use in generation tasks. |
  317. | `vip_text_to_video_1080p` | `prompt`, `aspect_ratio`, `duration` | VIP 1080p text-to-video — priority queue, low censorship. *(Coming Soon)* |
  318. | `vip_text_to_video_fast_1080p` | `prompt`, `aspect_ratio`, `duration` | VIP 1080p fast text-to-video — fastest 1080p T2V with priority queue. *(Coming Soon)* |
  319. | `vip_image_to_video_1080p` | `prompt`, `images_list`, `aspect_ratio`, `duration` | VIP 1080p image-to-video — priority queue, low censorship. *(Coming Soon)* |
  320. | `vip_image_to_video_fast_1080p` | `prompt`, `images_list`, `aspect_ratio`, `duration` | VIP 1080p fast image-to-video — fastest 1080p I2V with priority queue. *(Coming Soon)* |
  321. | `get_result` | `request_id` | Check task status for the Seedance API. |
  322. | `wait_for_completion` | `request_id`, `poll_interval`, `timeout` | Blocking helper for Seedance generation tasks. |
  323. ---
  324. ## 🔗 Official Resources
  325. - **Developer Guide**: [Seedance 2.0 API: Complete Tutorial](https://medium.com/@anilmatcha/seedance-2-0-api-complete-developer-guide-text-to-video-image-to-video-python-sdk-1479f5e5491f)
  326. - **Playground — Seedance 2.0**: [I2V](https://muapi.ai/playground/seedance-v2.0-i2v?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [Extend](https://muapi.ai/playground/seedance-v2.0-extend?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  327. - **Playground — Seedance 2.0 Mini** *(coming soon)*: [I2V](https://muapi.ai/playground/seedance-2.0-mini-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [T2V](https://muapi.ai/playground/seedance-2.0-mini-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  328. - **Playground — Seedance 2.1** *(coming soon)*: [I2V](https://muapi.ai/playground/seedance-2.1-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [T2V](https://muapi.ai/playground/seedance-2.1-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  329. - **Playground — Seedance 2.5** *(coming soon)*: [I2V](https://muapi.ai/playground/seedance-2.5-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api) · [T2V](https://muapi.ai/playground/seedance-2.5-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  330. - **API Provider**: [MuAPI.ai](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-api)
  331. ## 📄 License
  332. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  333. ---
  334. **Keywords**: Seedance 2.0 API, Seedance 2 Mini API, Seedance 2 Mini, ByteDance Seedance, AI Video Generator, Text-to-Video AI, Image-to-Video API, Seedance Python SDK, Seedance V2 API, Seedance Mini, Seedance 2 Mini Python, Seedance 2 Mini Text-to-Video, Seedance 2 Mini Image-to-Video, 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.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.