Skip to content
Back to search

Seedance-2.5-API

Python wrapper for ByteDance's Seedance 2.5 API — Text-to-Video, Image-to-Video, realistic human faces, native 4K, 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/SamurAIGPT/Seedance-2.5-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/SamurAIGPT/Seedance-2.5-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/samuraigpt--seedance-2-5-api/badge.svg)](/listings/samuraigpt--seedance-2-5-api)

HTML

<a href="/listings/samuraigpt--seedance-2-5-api"><img src="/api/listings/samuraigpt--seedance-2-5-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.5 API repository
git clone https://github.com/SamurAIGPT/Seedance-2.5-API.git
cd Seedance-2.5-API

# Install required dependencies
pip install -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-5-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 · 452 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.5 API & Seedance 2.5 Flash 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-5-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/SamurAIGPT/Seedance-2.5-API.svg)](https://github.com/SamurAIGPT/Seedance-2.5-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.5 API** (developed by ByteDance), delivered via [muapi.ai](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api). Generate cinematic, high-fidelity AI videos from text prompts and static images — with industry-leading **realistic human face generation** — using ByteDance's most advanced video generation model.
  8. Join the subreddit https://www.reddit.com/r/Seedance_2_API/ for discussions on using the Seedance 2.5 API.
  9. > 🌟 **Seedance 2.5** now exposes 72 early-access routes across Text-to-Video, Image-to-Video, First & Last Frame, Omni Reference, Video Edit, and Video Extend. Every workflow is available in standard, Intl, and Spicy variants with 480p, 720p, upscaled 1080p, and upscaled 4K tiers. Clips support 4–30 seconds; Omni Reference accepts up to 30 images, 10 videos, and 10 audio files. Try it now: [I2V Playground](https://muapi.ai/playground/seedance-2.5-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [T2V Playground](https://muapi.ai/playground/seedance-2.5-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api)
  10. ## 📺 Video Tutorial
  11. [![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)
  12. **[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-5-api).
  13. > **Seedance 2.5 Spicy API:** This SDK includes the relaxed-content-safety route family, sometimes searched as an “uncensored Seedance 2.5 API.” “Spicy” means reduced filtering, not unrestricted generation; provider terms still apply.
  14. ## Related Projects
  15. - [seedance-2.0-watermark-remover](https://github.com/SamurAIGPT/seedance-2.0-watermark-remover) — Remove watermarks from your Seedance generated videos
  16. - [seedance-2-generator](https://github.com/SamurAIGPT/seedance-2-generator) — Ready-made Next.js SaaS built on Seedance 2
  17. - [Seedance-2-API](https://github.com/Anil-matcha/Seedance-2-API) — Python wrapper covering Seedance 2.0 and Seedance 2 Mini
  18. - [Seedance-3-API](https://github.com/Anil-matcha/Seedance-3-API) — companion project for the next Seedance API generation on MuAPI
  19. - [awesome-seedance-3-api-prompts](https://github.com/SamurAIGPT/awesome-seedance-3-api-prompts) — Seedance 3 prompt library and integration status
  20. - [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
  21. - [seedance2.5-comfyui](https://github.com/Anil-matcha/seedance2.5-comfyui) — Native Seedance 2.5 ComfyUI custom nodes and example workflows
  22. - [seedance-2.5-mcp](https://github.com/Anil-matcha/seedance-2.5-mcp) — Focused MCP server for the standard 720p and 480p Seedance 2.5 Preview routes
  23. - [seedance-2-mcp](https://github.com/Anil-matcha/seedance-2-mcp) — Focused MCP server for the related Seedance 2 workflows
  24. - [flux-3-video-api](https://github.com/SamurAIGPT/flux-3-video-api) — Python wrapper for Black Forest Labs' FLUX 3 Text-to-Video and Image-to-Video
  25. ## Seedance 2.5 Flash API
  26. 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.
  27. 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-5-api)**. Eighteen Flash endpoints are live through one Muapi key: six standard, six **international** (Dreamina route, `-intl-`) and six **spicy** (relaxed content moderation, `nsfw-seedance-2-5-flash`), using the same submit-and-poll flow as the flagship routes below.
  28. | Mode | Standard | International | Spicy |
  29. |---|---|---|---|
  30. | Text-to-Video | `seedance-2.5-flash-text-to-video` | `seedance-2.5-flash-intl-text-to-video` | `seedance-2.5-flash-spicy-text-to-video` |
  31. | Image-to-Video | `seedance-2.5-flash-image-to-video` | `seedance-2.5-flash-intl-image-to-video` | `seedance-2.5-flash-spicy-image-to-video` |
  32. | First & Last Frame | `seedance-2.5-flash-first-last-frame` | `seedance-2.5-flash-intl-first-last-frame` | `seedance-2.5-flash-spicy-first-last-frame` |
  33. | Reference-to-Video (10 images / 5 videos / 5 audios) | `seedance-2.5-flash-reference-to-video` | `seedance-2.5-flash-intl-reference-to-video` | `seedance-2.5-flash-spicy-reference-to-video` |
  34. | Video Edit | `seedance-2.5-flash-video-edit` | `seedance-2.5-flash-intl-video-edit` | `seedance-2.5-flash-spicy-video-edit` |
  35. | Video Extend | `seedance-2.5-flash-video-extend` | `seedance-2.5-flash-intl-video-extend` | `seedance-2.5-flash-spicy-video-extend` |
  36. Flash outputs 480p or 720p, 4-30 seconds with native audio. Pricing on Muapi: `$0.114/sec` (480p) and `$0.228/sec` (720p), 33% below Seedance 2.5; international and spicy are `$0.1254/sec` and `$0.2508/sec` (Flash +10%, 33% below the matching Seedance 2.5 tier). Edit and extend bill output plus source-video seconds at 65% of that rate. Use flagship Seedance 2.5 for 1080p and 4K.
  37. ```python
  38. from seedance_api import SeedanceAPI
  39. api = SeedanceAPI()
  40. job = api.flash_text_to_video("A cat slowly blinks, static camera", resolution="480p", duration=4)
  41. intl = api.flash_image_to_video("Slow push-in", "https://example.com/a.jpg", intl=True, resolution="720p")
  42. spicy = api.flash_image_to_video("Slow push-in", "https://example.com/a.jpg", spicy=True, resolution="720p")
  43. ```
  44. ## 🚀 Why Use Seedance 2.5 API?
  45. Seedance 2.5 is ByteDance's most advanced video generation model, offering unparalleled video quality and motion consistency.
  46. - **Longer Clips**: Generate up to 30 seconds per clip (up from 15s on Seedance 2.0).
  47. - **Realistic Human Faces**: Best-in-class facial fidelity — natural expressions, skin detail, and identity consistency across frames.
  48. - **Less Censorship**: More permissive content policy compared to other AI video models, enabling a wider range of creative use cases.
  49. - **Superior Motion Control**: Advanced camera movement and improved character consistency for professional results.
  50. - **Multimodal API**: Supports Text-to-Video (T2V), Image-to-Video (I2V), First & Last Frame keyframe transitions, Omni Reference, Video Edit, and Video Extend.
  51. - **Developer-First**: Fast processing via the MuAPI infrastructure with a simple Python SDK.
  52. ## 🌟 Key Features of Seedance 2.5 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.5 Text-to-Video (T2V)**: Transform complex descriptive prompts into stunning AI video clips, up to 30s long.
  55. - ✅ **Seedance 2.5 Image-to-Video (I2V)**: Animate a single static image with precise motion control using `image_url`.
  56. - ✅ **Seedance 2.5 First & Last Frame**: Generate a smooth keyframe-driven transition between a start and end image.
  57. - ✅ **Seedance 2.5 Omni Reference**: Condition a video on any combination of image, video, and audio references in one request — up to 30 reference images, 10 reference videos, and 10 reference audio clips.
  58. - ✅ **Seedance Character**: Generate a multi-panel character sheet (front, back, side, action pose, expressions) from 1–3 reference photos, then anchor an Omni-Reference generation on it via `consistent_video()` for consistent identity across shots.
  59. - ✅ **Resolution Tiers**: Choose 480p for fast drafts, 720p for the standard tier, or upscaled 1080p and 4K routes for higher-resolution deliverables.
  60. - ✅ **Intl and Spicy Variants**: Select the international or relaxed-content-safety route family without changing the request shape.
  61. - ✅ **Video Edit and Extend**: Edit an input video with reference images/audio or continue it from its last frame, with optional synchronized audio generation.
  62. - ✅ **Reproducible Seeds**: Pass `seed` to keep generations in the same neighborhood across repeated calls.
  63. - ✅ **File Upload**: Directly upload local images and videos using the `upload_file` method, supporting seamless use in generation tasks.
  64. - ✅ **Less Censorship**: More permissive content policy than competing models — broader creative freedom out of the box.
  65. - ✅ **Flexible Aspect Ratios**: `16:9`, `9:16` (TikTok/Reels), `1:1`, `4:3`, `3:4`, `21:9`, `9:21`.
  66. > **Resolution note**: The 1080p and 4K routes are upscaled from the model's 720p base render. They are separate routes and are priced above the standard 720p tier.
  67. > **Access note**: Seedance 2.5 is an early-access build on MuAPI, gated to Pro/Business plan accounts.
  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.5 API repository
  77. git clone https://github.com/SamurAIGPT/Seedance-2.5-API.git
  78. cd Seedance-2.5-API
  79. # Install required dependencies
  80. pip install -r requirements.txt
  81. ```
  82. ### Configuration
  83. 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-5-api) API key:
  84. ```env
  85. MUAPI_API_KEY=your_muapi_api_key_here
  86. ```
  87. ---
  88. ## 🤖 Seedance 2.5 MCP Server (New!)
  89. You can now use Seedance 2.5 as an **MCP (Model Context Protocol)** server. This allows AI models (like Claude Desktop or Cursor) to directly invoke Seedance tools.
  90. The `generate_seedance_25` tool accepts the exact endpoint slug from the route
  91. matrix, so MCP clients can select any standard, Intl, or Spicy workflow and
  92. resolution tier without waiting for a new tool wrapper.
  93. ### Running the MCP Server
  94. 1. Ensure `MUAPI_API_KEY` is set in your environment.
  95. 2. Run the server:
  96. ```bash
  97. python3 mcp_server.py
  98. ```
  99. 3. To test with the MCP Inspector:
  100. ```bash
  101. npx -y @modelcontextprotocol/inspector python3 mcp_server.py
  102. ```
  103. ---
  104. ## 💻 Quick Start with Seedance 2.5 API (Python)
  105. ```python
  106. from seedance_api import SeedanceAPI
  107. # Initialize the Seedance 2.5 client
  108. api = SeedanceAPI()
  109. # 1. Generate Video from Text (T2V) using Seedance 2.5 API
  110. print("Generating AI Video using Seedance 2.5...")
  111. submission = api.text_to_video(
  112. prompt="A cinematic slow-motion shot of a cyberpunk city in the rain, neon lights reflecting on puddles, 8k resolution",
  113. aspect_ratio="16:9",
  114. duration=5,
  115. )
  116. # 2. Wait for completion
  117. result = api.wait_for_completion(submission['request_id'])
  118. video_url = result.get("output", {}).get("video") or result.get("url")
  119. print(f"Success! View your Seedance 2.5 video here: {video_url}")
  120. ```
  121. ---
  122. ## 📡 API Endpoints & Reference
  123. The base URL is `https://api.muapi.ai/api/v1`. MuAPI exposes 72 Seedance 2.5
  124. routes: six workflows × three variants × four resolution tiers. Every route
  125. returns a `request_id` that can be polled with the result endpoint below.
  126. ### Route matrix
  127. The route names below are the 720p bases. Append `-480p`, `-1080p`, or `-4k`
  128. to select another tier; the unsuffixed route is 720p. The 1080p and 4K routes
  129. are upscaled from the 720p base render.
  130. | Variant | Text-to-Video | Image-to-Video | First & Last Frame | Omni Reference | Video Edit | Video Extend |
  131. |---|---|---|---|---|---|---|
  132. | Standard | `seedance-2.5-text-to-video` | `seedance-2.5-image-to-video` | `seedance-2.5-first-last-frame` | `seedance-2.5-omni-reference` | `seedance-2.5-video-edit` | `seedance-2.5-video-extend` |
  133. | Intl | `seedance-2.5-intl-text-to-video` | `seedance-2.5-intl-image-to-video` | `seedance-2.5-intl-first-last-frame` | `seedance-2.5-intl-omni-reference` | `seedance-2.5-intl-video-edit` | `seedance-2.5-intl-video-extend` |
  134. | Spicy | `seedance-2.5-spicy-text-to-video` | `seedance-2.5-spicy-image-to-video` | `seedance-2.5-spicy-first-last-frame` | `seedance-2.5-spicy-omni-reference` | `seedance-2.5-spicy-video-edit` | `seedance-2.5-spicy-video-extend` |
  135. Standard and Intl pricing is `$0.17/sec` at 480p, `$0.34/sec` at 720p,
  136. `$0.85/sec` at 1080p, and `$1.70/sec` at 4K for T2V/I2V/keyframe/Omni
  137. routes. Video Edit and Video Extend start at `$0.1105/sec`, `$0.221/sec`,
  138. `$0.5525/sec`, and `$1.105/sec` respectively because the input video is
  139. priced with the reference-video rate. Spicy routes use the same shapes and
  140. are priced 10% above the matching standard tier.
  141. ### Text-to-Video and Image-to-Video
  142. ```bash
  143. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-text-to-video-1080p" \
  144. --header "Content-Type: application/json" \
  145. --header "x-api-key: YOUR_API_KEY" \
  146. --data-raw '{
  147. "prompt": "A majestic eagle soaring over the snow-capped Himalayas",
  148. "aspect_ratio": "16:9",
  149. "duration": 5,
  150. "seed": 42
  151. }'
  152. ```
  153. Image-to-Video uses one `image_url` (not a list):
  154. ```bash
  155. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-intl-image-to-video" \
  156. --header "Content-Type: application/json" \
  157. --header "x-api-key: YOUR_API_KEY" \
  158. --data-raw '{
  159. "prompt": "The camera slowly pushes in as the subject turns toward the light",
  160. "image_url": "https://example.com/photo.jpg",
  161. "aspect_ratio": "16:9",
  162. "duration": 8
  163. }'
  164. ```
  165. ### First & Last Frame
  166. Pass exactly two URLs in `images_list`, in start/end order:
  167. ```bash
  168. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-spicy-first-last-frame-480p" \
  169. --header "Content-Type: application/json" \
  170. --header "x-api-key: YOUR_API_KEY" \
  171. --data-raw '{
  172. "prompt": "Smooth cinematic transition as the scene shifts from day to night",
  173. "images_list": ["https://example.com/start.jpg", "https://example.com/end.jpg"],
  174. "aspect_ratio": "16:9",
  175. "duration": 5
  176. }'
  177. ```
  178. ### Omni Reference
  179. Omni Reference accepts up to 30 images, 10 video clips, and 10 audio files:
  180. ```bash
  181. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-omni-reference-4k" \
  182. --header "Content-Type: application/json" \
  183. --header "x-api-key: YOUR_API_KEY" \
  184. --data-raw '{
  185. "prompt": "A dramatic chase through a neon city, matching the reference style and camera rhythm",
  186. "aspect_ratio": "16:9",
  187. "duration": 5,
  188. "images_list": ["https://example.com/scene.jpg"],
  189. "videos_list": ["https://example.com/motion.mp4"],
  190. "audios_list": ["https://example.com/mood.mp3"]
  191. }'
  192. ```
  193. ### Video Edit
  194. Video Edit takes a single source `video`, optional `reference_images` and
  195. `reference_audios`, and a `generate_audio` flag:
  196. ```bash
  197. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-video-edit-1080p" \
  198. --header "Content-Type: application/json" \
  199. --header "x-api-key: YOUR_API_KEY" \
  200. --data-raw '{
  201. "prompt": "Turn the sunny afternoon into a rainy blue-hour scene while preserving the subject and camera movement",
  202. "video": "https://example.com/input.mp4",
  203. "reference_images": ["https://example.com/style.jpg"],
  204. "generate_audio": true,
  205. "duration": 8,
  206. "aspect_ratio": "16:9"
  207. }'
  208. ```
  209. ### Video Extend
  210. Video Extend continues from the source video's final frame. Set `last_image`
  211. when the continuation should interpolate toward a target frame:
  212. ```bash
  213. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2.5-intl-video-extend-4k" \
  214. --header "Content-Type: application/json" \
  215. --header "x-api-key: YOUR_API_KEY" \
  216. --data-raw '{
  217. "prompt": "Continue the camera move forward into the glowing city entrance",
  218. "video": "https://example.com/input.mp4",
  219. "last_image": "https://example.com/target.jpg",
  220. "duration": 5,
  221. "generate_audio": true
  222. }'
  223. ```
  224. ### Polling for Results
  225. ```python
  226. import time
  227. import requests
  228. def wait_for_result(request_id, api_key, poll_interval=5, timeout=600):
  229. start = time.time()
  230. while time.time() - start < timeout:
  231. result = requests.get(
  232. "https://api.muapi.ai/api/v1/predictions/{}/result".format(request_id),
  233. headers={"x-api-key": api_key},
  234. ).json()
  235. if result["status"] == "completed":
  236. return result
  237. if result["status"] == "failed":
  238. raise RuntimeError(result.get("error", "Generation failed"))
  239. time.sleep(poll_interval)
  240. raise TimeoutError("Generation timed out")
  241. ```
  242. ### MuAPI Parameters
  243. | Parameter | Type | Applies to | Description |
  244. |---|---|---|---|
  245. | `prompt` | string | All routes | Required scene, motion, edit, or continuation instructions |
  246. | `image_url` | URL | Image-to-Video | One input image |
  247. | `images_list` | URL array | First & Last / Omni | Exactly 2 keyframes, or up to 30 Omni references |
  248. | `videos_list` | URL array | Omni Reference | Up to 10 reference clips |
  249. | `audios_list` | URL array | Omni Reference | Up to 10 reference audio files |
  250. | `video` | URL | Video Edit / Extend | Source video; clips longer than 30s are trimmed |
  251. | `reference_images` | URL array | Video Edit | Optional identity/style references, up to 30 |
  252. | `reference_audios` | URL array | Video Edit | Optional audio references, up to 10 |
  253. | `last_image` | URL | Video Extend | Optional target frame for the continuation |
  254. | `generate_audio` | boolean | Video Edit / Extend | Generate new synchronized audio; defaults to `true` |
  255. | `aspect_ratio` | string | All routes | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, or `9:21` |
  256. | `duration` | integer | All routes | `4`–`30` seconds; default `5` |
  257. | `seed` | integer | All routes | `-1`–`4294967295`; use `-1` for random |
  258. | `webhook_url` | URL | All routes | Optional completion webhook |
  259. ### Seedance Character (Consistent Character Sheets)
  260. **Endpoint**: `POST https://api.muapi.ai/api/v1/seedance-2-character`
  261. 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.
  262. Once the sheet is generated, pass its URL into `consistent_video()`, which anchors an Omni-Reference generation on it for consistent character identity across shots.
  263. | Field | Type | Required | Description |
  264. |---|---|---|---|
  265. | `images_list` | array of URLs | Yes | 1–3 photos of the reference person |
  266. | `prompt` | string | Yes | Desired outfit/style for the character |
  267. ```bash
  268. curl --location --request POST "https://api.muapi.ai/api/v1/seedance-2-character" \
  269. --header "Content-Type: application/json" \
  270. --header "x-api-key: YOUR_API_KEY" \
  271. --data-raw '{
  272. "images_list": ["https://example.com/person.jpg"],
  273. "prompt": "cyberpunk jacket with neon accents"
  274. }'
  275. ```
  276. **Cost:** $0.18 per character sheet
  277. For a full guide, see [CHARACTER_CONSISTENCY.md](CHARACTER_CONSISTENCY.md).
  278. ### Legacy Seedance 2.0 routes
  279. The SDK also keeps `legacy_video_edit()` and `legacy_extend_video()` for
  280. applications that still use the older request-ID based Seedance 2.0 routes.
  281. Use `video_edit()` and `video_extend()` for the dedicated Seedance 2.5
  282. Video Edit and Video Extend routes described above.
  283. ---
  284. ## 🎭 Character Consistency Workflow
  285. Create a fictional character from reference photos and maintain their identity across multiple video scenes using the Omni-Reference endpoint.
  286. See [CHARACTER_CONSISTENCY.md](CHARACTER_CONSISTENCY.md) for a full guide.
  287. ```python
  288. from seedance_api import SeedanceAPI
  289. api = SeedanceAPI()
  290. # Step 1 — generate a character sheet (1–3 reference photos)
  291. char = api.create_character(
  292. images_list=["https://example.com/person.jpg"],
  293. outfit_description="cyberpunk jacket with neon accents, glowing visor",
  294. )
  295. char_id = char["request_id"]
  296. sheet_result = api.wait_for_completion(char_id)
  297. sheet_url = sheet_result["outputs"][0]
  298. # Step 2 — anchor a generation on the sheet via consistent_video() (Omni-Reference)
  299. video = api.consistent_video(
  300. sheet_url=sheet_url,
  301. prompt="The character rides a motorcycle through a neon-lit city at night",
  302. aspect_ratio="16:9",
  303. duration=5,
  304. )
  305. result = api.wait_for_completion(video["request_id"])
  306. print(f"Video: {result['outputs'][0]}")
  307. # Add extra scene/prop reference images alongside the character sheet
  308. video2 = api.consistent_video(
  309. sheet_url=sheet_url,
  310. prompt="The character draws their weapon in slow motion, dramatic lighting",
  311. aspect_ratio="16:9",
  312. duration=5,
  313. extra_images=["https://example.com/background.jpg"],
  314. )
  315. result2 = api.wait_for_completion(video2["request_id"])
  316. print(f"Video: {result2['outputs'][0]}")
  317. ```
  318. ---
  319. ## 📖 Documentation & Guides
  320. For prompt engineering and advanced use cases, see [awesome-seedance-2.5-api-prompts](https://github.com/Anil-matcha/awesome-seedance-2.5-api-prompts).
  321. | Method | Parameters | Description |
  322. | :--- | :--- | :--- |
  323. | `generate` | `endpoint`, `prompt`, workflow-specific fields, `aspect_ratio`, `duration`, `seed` | Call any of the 72 Seedance 2.5 routes directly. |
  324. | `text_to_video` | `prompt`, `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Generate text-to-video; variant is `standard`, `intl`, or `spicy`, and resolution is `480p`, `720p`, `1080p`, or `4k`. |
  325. | `text_to_video_480p` / `_1080p` / `_4k` | same as above | Convenience methods for standard or selected-variant resolution tiers. |
  326. | `image_to_video` | `prompt`, `image_url`, `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Animate a single image. |
  327. | `image_to_video_480p` / `_1080p` / `_4k` | same as above | Convenience methods for image-to-video resolution tiers. |
  328. | `first_last_frame` | `prompt`, `images_list` (exactly 2), `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Keyframe transition between a start and end image. |
  329. | `first_last_frame_480p` / `_1080p` / `_4k` | same as above | Convenience methods for keyframe resolution tiers. |
  330. | `omni_reference` | `prompt`, `images_list`, `videos_list`, `audios_list`, `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Multimodal reference generation — up to 30 images / 10 videos / 10 audio clips. |
  331. | `omni_reference_480p` / `_1080p` / `_4k` | same as above | Convenience methods for Omni Reference resolution tiers. |
  332. | `video_edit` | `prompt`, `video`, `reference_images`, `reference_audios`, `generate_audio`, `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Edit an existing video through a dedicated Seedance 2.5 route. |
  333. | `video_edit_480p` / `_1080p` / `_4k` | same as above | Convenience methods for Video Edit resolution tiers. |
  334. | `video_extend` | `prompt`, `video`, `last_image`, `generate_audio`, `aspect_ratio`, `duration`, `seed`, `variant`, `resolution` | Continue an existing video from its last frame. |
  335. | `video_extend_480p` / `_1080p` / `_4k` | same as above | Convenience methods for Video Extend resolution tiers. |
  336. | `intl_*` / `spicy_*` | Same workflow fields plus `resolution` | Explicit helpers for the Intl and Spicy route families. |
  337. | `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. |
  338. | `consistent_video` | `sheet_url`, `prompt`, `aspect_ratio`, `duration`, `extra_images` | Omni-Reference generation anchored on the character sheet. |
  339. | `watermark_remover`| `video_url` | Remove MuAPI watermark from a Seedance video. |
  340. | `watermark_remover_pro`| `video_url` | Remove MuAPI watermark from a Seedance video (Pro version). |
  341. | `legacy_video_edit` | `prompt`, `video_urls`, `images_list`, `aspect_ratio`, `quality`, `remove_watermark`, `output_format` | Legacy Seedance 2.0 edit route. |
  342. | `legacy_extend_video` | `request_id`, `prompt`, `duration`, `quality`, `output_format` | Legacy Seedance 2.0 extension route. |
  343. | `upload_file` | `file_path` | Upload a local file (image or video) to MuAPI for use in generation tasks. |
  344. | `get_result` | `request_id` | Check task status for the Seedance API. |
  345. | `wait_for_completion` | `request_id`, `poll_interval`, `timeout` | Blocking helper for Seedance generation tasks. |
  346. ---
  347. ## 🔗 Official Resources
  348. - **Playground — Seedance 2.5**:
  349. - [Text-to-Video](https://muapi.ai/playground/seedance-2.5-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [Image-to-Video](https://muapi.ai/playground/seedance-2.5-image-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [First & Last Frame](https://muapi.ai/playground/seedance-2.5-first-last-frame?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [Omni Reference](https://muapi.ai/playground/seedance-2.5-omni-reference?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api)
  350. - [Video Edit](https://muapi.ai/playground/seedance-2.5-video-edit?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [Video Extend](https://muapi.ai/playground/seedance-2.5-video-extend?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api)
  351. - [Intl Text-to-Video](https://muapi.ai/playground/seedance-2.5-intl-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api) · [Spicy Text-to-Video](https://muapi.ai/playground/seedance-2.5-spicy-text-to-video?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api)
  352. - **API Provider**: [MuAPI.ai](https://muapi.ai?utm_source=github&utm_medium=readme&utm_campaign=seedance-2-5-api)
  353. ## 📄 License
  354. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  355. ---
  356. **Keywords**: Seedance 2.5 API, ByteDance Seedance, AI Video Generator, Text-to-Video AI, Image-to-Video API, Seedance Python SDK, 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.5 Tutorial.

Ratings and comments

Sign in to rate this skill.

Sign in

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