Built for fast preview loops
Use Seedance 2.0 Mini API style requests to test prompts, compare motion ideas, and create compact clips before moving to longer production renders.
Seedance 2.0 Mini API guide
Seedance 2.0 Mini API for fast AI video generation
The Seedance 2.0 Mini API page explains how to build a lightweight generation flow on Seedance API v2. Use the seedance-2-mini model for compact clips, previews, social video, and high-volume product workflows without custom GPU infrastructure.
- Clip length
- 4-15s
- Model path
- Mini
- Inputs
- T2V + I2V
- Interface
- REST
4-15 second jobs
Use seedance-2-mini
Prompt or reference images
JSON over HTTPS
Mini-style request
Start with the native Seedance 2.0 Mini model
curl -X POST 'https://seedanceapi.org/v2/generate' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-mini",
"prompt": "A compact product reveal with smooth camera motion",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "1:1"
}'Seedance API v2 exposes seedance-2-mini for Mini jobs. Use 4-15 second durations, 480p or 720p output, and compact prompts for lightweight generation.
Why use a Seedance 2.0 Mini API workflow?
A Seedance 2.0 Mini API workflow is useful when teams need speed, predictable costs, and simple REST integration more than long-form cinematic rendering.
Simple API-key access
Developers can authenticate with Bearer tokens, create jobs with POST /v2/generate, and poll GET /v2/status using the same API pattern as the full Seedance 2.0 API.
Production-friendly boundaries
Short duration, clear aspect ratios, and async status polling make the Seedance 2.0 Mini API workflow easier to fit into product queues and moderation flows.
Seedance 2.0 Mini API capabilities
The Mini API workflow focuses on the subset of Seedance 2.0 API features that matter for lightweight video apps and automated preview generation.
Native Mini model
Set model to seedance-2-mini when you want Seedance 2.0 Mini API behavior for quicker iteration and smaller jobs.
Text-to-video clips
Send a concise prompt, aspect ratio, resolution, and duration to generate short video assets for apps, social media, and creative testing.
Image-to-video motion
Provide one to four image URLs, or Mini-compatible reference video URLs, while keeping a compact Seedance 2.0 Mini API request payload.
Short durations
Use any integer duration from 4 to 15 seconds, with 8 seconds as a practical starting point for Mini API previews.
Async status polling
Every request returns a task id, so your app can poll status, update UI state, and fetch the final video URL when it is ready.
Shared v2 foundation
The Seedance 2.0 Mini API workflow uses the same v2 authentication, billing, and response shape as the broader Seedance 2.0 API.
How to use Seedance 2.0 Mini API
Start with the existing Seedance API v2 endpoints and tune your request for compact output.
Create an API key
Sign in, open the API Keys page, and copy a key for server-side use. Keep the key out of browser code and public repositories.
Submit a Mini job
Call POST /v2/generate with model seedance-2-mini, a tight prompt, duration 8, resolution 720p, and the aspect ratio your surface needs.
Poll and render
Use GET /v2/status with the returned task_id. When status is SUCCESS, read data.response[0] and display or store the video URL.
Seedance 2.0 Mini API request pattern
The Mini API flow stays intentionally small: authenticate, create a generation task, then poll for completion.
POST /v2/generate
Creates a Seedance 2.0 Mini generation task. Use text prompts for text-to-video, images for image-to-video, or reference_video_urls when your workflow needs video input.
GET /v2/status
Returns processing state, failure details, or the final response array with the generated video URL.
Optional callback URL
For async systems, include a public callback_url when supported by your integration. Do not use localhost URLs.
Recommended Mini API parameters
| Parameter | Recommended value |
|---|---|
| model | Use seedance-2-mini for the Mini API workflow. |
| prompt | Keep it focused and specific; max 2000 characters. |
| duration | Use any integer from 4 to 15 seconds. |
| resolution | Use 480p or 720p for Mini output. |
| aspect_ratio | Use 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, or adaptive for text-to-video. |
| images | Use one to four HTTPS image URLs for image-to-video. |
| reference_video_urls | Optional Mini-compatible reference video URLs for video-guided generation. |
| reference_audio_urls | Optional reference audio URLs for Mini-compatible generation. |
| callback_url | Optional public webhook URL for async notifications. |
For a full parameter reference, use the Seedance 2.0 API v2 documentation. This page narrows the same API to a Mini-style implementation.
Best Seedance 2.0 Mini API use cases
Mini API workflows are best when users need quick motion previews or lightweight generated video inside an existing product.
Social video previews
Generate compact vertical clips for feed previews, ad ideas, and creator tools where speed matters.
Product motion tests
Animate product shots or campaign visuals with short image-to-video requests before approving final creative.
Prompt iteration tools
Let users test many prompt variants quickly, compare results, and promote the best prompt to a larger render.
High-volume automation
Use short fast jobs for batch previews, content pipelines, and apps that need predictable throughput.
Production integration notes
A Seedance 2.0 Mini API workflow still needs the same operational care as any production video API integration.
Run calls from your backend
Store API keys on your server, call Seedance API from backend code, and expose only your own safe endpoints to clients.
Queue and retry jobs
Use a queue to manage concurrency, retry transient failures, and keep the user interface responsive while video jobs process.
Track credits and status
Monitor credit usage, task status, and error responses so your Mini API workflow remains predictable as volume grows.
Seedance 2.0 Mini API vs standard v2 usage
Mini API is a workflow choice on top of Seedance API v2. Use it for fast clips, and switch to standard usage when quality or duration matters more.
Mini API is speed-oriented
Use fast routing, shorter durations, and tighter prompts when you need quick feedback.
Standard v2 is quality-oriented
Use the standard Seedance 2.0 model path when cinematic quality and richer scenes are the priority.
Both share one API base
Authentication, billing, status polling, and response parsing stay consistent across the Mini workflow and standard v2 usage.
| Capability | Mini workflow | Standard v2 usage |
|---|---|---|
| Model hint | seedance-2-mini | seedance-2.0 |
| Best duration | 4-15 seconds | 5, 10, or 15 seconds |
| Best use | Previews, batches, fast iteration | Final creative, richer storytelling |
| API shape | Same /v2/generate and /v2/status | Same /v2/generate and /v2/status |
Seedance 2.0 Mini API FAQ
Answers for developers evaluating a Seedance 2.0 Mini API style integration.
Is there a separate Seedance 2.0 Mini API endpoint?
Yes. Use Seedance API v2 with model seedance-2-mini. The public route is POST /v2/generate, followed by GET /v2/status.
What is Seedance 2.0 Mini API best for?
Seedance 2.0 Mini API workflows are best for short previews, social video tests, product motion drafts, and high-volume prompt iteration.
Can I use image-to-video with the Mini API workflow?
Yes. Send one to four image URLs in the images field and keep the prompt focused on the motion you want.
Which duration should I start with?
Mini supports any integer duration from 4 to 15 seconds. Start with 8 seconds for quick previews, then increase duration when you need a more complete scene.
Which aspect ratios are supported?
For text-to-video, Mini accepts 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, and adaptive. Choose the ratio that matches your placement.
How do I authenticate requests?
Pass Authorization: Bearer YOUR_API_KEY on every request. Keep that key on your backend and never expose it in client-side code.
How do I get the final video URL?
Poll GET /v2/status with task_id. When status is SUCCESS, read the first video URL from data.response[0].
Does this work with any programming language?
Yes. The Seedance 2.0 Mini API workflow uses standard HTTPS and JSON, so it works with cURL, Python, Node.js, Go, Java, and other HTTP clients.
Should I call the API directly from the browser?
No. Use your backend or BFF to protect API keys, validate prompts, enforce rate limits, and handle retries.
How is billing handled?
Seedance API uses credits. Cost depends on the model and duration, so Mini-style short fast jobs are easier to forecast.
Can I upgrade from Mini workflow to standard Seedance 2.0?
Yes. Keep the same endpoint and change your model hint, duration, and prompt strategy when you need higher-quality production renders.
Where can I find the complete API docs?
Open the Seedance 2.0 API v2 documentation for the full request schema, response examples, pricing tables, and error codes.
Build your first Seedance 2.0 Mini API job
Create an API key, send a short Mini request, and plug lightweight AI video generation into your product today.