Seedance 2.0 Mini integration
prompt is always required; supplying a first-frame image (and optionally a last-frame image_end) switches the model into image-to-video or first-to-last-frame transition mode.
Resolution is selected at generation time: there is a dedicated 480p generate endpoint and a dedicated 720p generate endpoint. Task listing and status use a single generic endpoint regardless of the resolution used to create the task.
Key capabilities
- Text-to-video and image-to-video: Generate from a text prompt alone, or guide generation with a first-frame
imageand optional last-frameimage_end - First-to-last-frame transitions: Provide both
imageandimage_endto generate a video that transitions between the two frames - Resolution by generate endpoint: Dedicated
480pand720pgenerate endpoints; resolution is not a body parameter - Unified task tracking: One generic list endpoint and one generic status endpoint cover tasks of any resolution
- Durations:
5or10seconds (default5) - Seven aspect ratios: From ultra-wide
film_horizontal_21_9to ultra-tallfilm_vertical_9_21, defaultwidescreen_16_9 - Camera control: Set
camera_fixedtotruefor a static tripod shot orfalsefor natural camera movement - Reproducible output: Provide a
seed(0 to 4294967295) to repeat results;-1selects a random seed - Safety filtering: Content safety checker is enabled by default via
enable_safety_checker - Async processing: Webhook notifications or polling for task completion
- 24-hour delivery: Generated MP4 video is returned via a URL valid for 24 hours
Use cases
- Social media content: Produce vertical
social_story_9_16clips for TikTok, Instagram Reels, and YouTube Shorts at low cost - High-volume generation: Batch-generate many short videos affordably for testing, previews, and A/B variations
- Product animation: Animate a product image, or transition between two product shots with first and last frame control
- Rapid prototyping: Iterate quickly on creative concepts before committing to higher-resolution models
- Ad variations: Generate multiple aspect ratios and durations from a single concept
Generation modes
| Mode | Required input | Optional input | Output behavior |
|---|---|---|---|
| Text-to-Video | prompt | aspect_ratio, duration, seed, camera_fixed | Video generated entirely from the text prompt |
| Image-to-Video | prompt + image | duration, seed, camera_fixed | Video starts from the first-frame image |
| First-to-last frame | prompt + image + image_end | duration, seed, camera_fixed | Video transitions from the first frame to the last frame |
API Operations
Generate a video using the480p or 720p endpoint, then track it with the generic list and status endpoints. Generation returns a task ID for async polling or webhook notification.
POST /v1/ai/video/seedance-2-mini-480p
POST /v1/ai/video/seedance-2-mini-720p
GET /v1/ai/video/seedance-2-mini
GET /v1/ai/video/seedance-2-mini/{task-id}
Endpoint structure
| Operation | Endpoint |
|---|---|
| Generate 480p | POST /v1/ai/video/seedance-2-mini-480p |
| Generate 720p | POST /v1/ai/video/seedance-2-mini-720p |
| List tasks | GET /v1/ai/video/seedance-2-mini |
| Get task | GET /v1/ai/video/seedance-2-mini/{task-id} |
Parameters
Resolution is determined by the generate endpoint you call (-480p or -720p) and is not a body parameter. The request body is identical for both endpoints.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Text description of the video, including scene, motion, visual style, and camera movements. Up to 2000 characters |
image | string | No | - | First-frame image for image-to-video, as a public URL or Base64 string. When provided, the video starts from this image |
image_end | string | No | - | Last-frame image, as a public URL or Base64 string. When provided together with image, the video transitions from the first frame to this frame |
duration | integer | No | 5 | Video length in seconds: 5 or 10 |
aspect_ratio | string | No | widescreen_16_9 | Output ratio: film_horizontal_21_9, widescreen_16_9, classic_4_3, square_1_1, traditional_3_4, social_story_9_16, film_vertical_9_21 |
camera_fixed | boolean | No | false | When true, the camera stays fixed (tripod shot); when false, natural camera movement may be applied |
seed | integer | No | -1 | Random seed for reproducible results (0 to 4294967295). Use -1 for a random seed |
enable_safety_checker | boolean | No | true | Enables content safety filtering on the generated video |
webhook_url | string | No | - | URL for async status notifications when the task completes |
Frequently Asked Questions
What is Seedance 2.0 Mini and how does it work?
What is Seedance 2.0 Mini and how does it work?
prompt (and optionally a first-frame image and last-frame image_end) to a resolution-specific generate endpoint and receive a task ID immediately. Poll the generic GET status endpoint or supply a webhook_url to be notified when the task completes, then download the MP4 video from the returned URL (valid for 24 hours).How do I choose 480p or 720p?
How do I choose 480p or 720p?
POST /v1/ai/video/seedance-2-mini-480p for 480p or POST /v1/ai/video/seedance-2-mini-720p for 720p. Task listing and status use the same generic endpoints regardless of resolution. Seedance 2.0 Mini supports 480p and 720p only.Do I need different endpoints to check task status by resolution?
Do I need different endpoints to check task status by resolution?
GET /v1/ai/video/seedance-2-mini lists all tasks and GET /v1/ai/video/seedance-2-mini/{task-id} returns the status of a single task, whether it was generated at 480p or 720p.What is the difference between text-to-video and image-to-video?
What is the difference between text-to-video and image-to-video?
prompt field is always required. For text-to-video, send only the prompt and the video is generated entirely from your description. For image-to-video, also send an image to use as the first frame; the video then starts from that image. To generate a transition video, send both image (first frame) and image_end (last frame).What video durations does Seedance 2.0 Mini support?
What video durations does Seedance 2.0 Mini support?
5 or 10 second videos. The default is 5 seconds. Duration is an integer value.What aspect ratios are available?
What aspect ratios are available?
film_horizontal_21_9 (21:9), widescreen_16_9 (16:9, default), classic_4_3 (4:3), square_1_1 (1:1), traditional_3_4 (3:4), social_story_9_16 (9:16), and film_vertical_9_21 (9:21).What image formats can I use for image-to-video?
What image formats can I use for image-to-video?
image and image_end either as a publicly accessible URL or as a Base64-encoded string. image sets the first frame; adding image_end produces a first-to-last-frame transition.Can I reproduce the same video?
Can I reproduce the same video?
seed value (from 0 to 4294967295) together with the same prompt and parameters to get consistent results. Use -1 (the default) for a random seed on each request.How long does generation take and how do I get the result?
How long does generation take and how do I get the result?
webhook_url to be notified on completion. The result MP4 is delivered via a URL that remains valid for 24 hours.What are the rate limits for Seedance 2.0 Mini?
What are the rate limits for Seedance 2.0 Mini?
How much does Seedance 2.0 Mini cost?
How much does Seedance 2.0 Mini cost?
Best practices
- Resolution choice: Use the
-480pendpoint for the lowest cost and fastest generation, and the-720pendpoint when you need more detail - Prompt writing: Be specific about the scene, subjects, motion, camera movement, lighting, and visual style for better results
- Image-to-video: Provide a clear, high-quality first-frame
image; addimage_endonly when you want a transition between two frames - Camera control: Set
camera_fixedtotruefor stable product or talking-head shots, andfalseto let the model add natural motion - Reproducibility: Fix the
seedwhile iterating on a prompt so you can compare changes consistently - Duration selection: Start at
5seconds for fast iterations, then switch to10seconds for final outputs - Production integration: Use webhooks instead of polling for scalable applications
- Result retrieval: Download the output promptly, as the delivery URL is valid for 24 hours
Related APIs
- Kling 3.0 Turbo: Speed-optimized Kling model with 720p and 1080p generate endpoints
- WAN 2.7: Alternative text-to-video and image-to-video model with multi-shot sequences
- Kling 3: Higher-fidelity Kling 3.0 model for premium output