# Seedance 2.0 Mini

Source: https://wanapi.app/models/seedance-2-0-mini

Seedance 2.0 Mini combines text and reference media for short video with synchronized audio. Start with a simple composition, give the scene one deliberate movement, and judge whether the complete clip serves your edit.

Prepare a Seedance 2.0 Mini request below. Sign in to review your balance, current pricing and generation availability before creating a video.

## What is Seedance 2.0 Mini?

Seedance 2.0 Mini is a distinct ByteDance video model within the 2.0 family. It creates four-to-fifteen-second clips at 480p or 720p and can generate the soundtrack alongside the picture. Its model identifier and pricing are separate from Fast and standard 2.0.

Treat Seedance 2.0 Mini as an option to evaluate for a defined short-video brief. A calm background, a product atmosphere or a small environmental movement gives you concrete details to inspect. The model name alone does not determine whether the result will meet your quality threshold.

Seedance 2.0 Mini accepts up to nine image, three video and three audio references. These are per-type limits, with additional restrictions on media duration and input combinations.

- Single generation: up to 15 seconds
- Output options: 480p, 720p; model version and input-mode restrictions apply.
- References: 9 images, 3 video clips, 3 audio clips.

## Seedance 2.0 Mini: an autumn park scene

Seedance 2.0 Mini · 720p · approximately 5 seconds · includes audio. An existing model sample; the two stills come from this same clip.

Prompt: Autumn leaves fall slowly in a quiet park, a bench in soft morning light, gentle camera push-in

The Seedance 2.0 Mini example uses falling leaves and a slow camera move around a bench. Watch whether the bench geometry remains steady and whether the leaves move continuously. This quiet scene is not a matched comparison with the Fast beach sample.

[Sample video](https://wanapi.app/media/seedance/seedance-2-0-mini/sample.mp4)

## Seedance 2.0 Mini pricing

Seedance 2.0 Mini prices below use current rates and 16:9 output at 24 fps. Compare the estimate for your actual input mode. Longer clips and reference videos can increase total usage even when the displayed token rate is lower.

Seedance 2.0 Mini bills video tokens, including reference-video input when supplied. Generated audio does not introduce a separate price tier. Use the current estimate for budgeting; a sample file does not establish the cost of a different request.

Estimates use 16:9 output at 24 fps. Other aspect ratios and actual output dimensions can change the cost.
Without reference video, only output seconds count. With reference video, input and output seconds count; billable input time is at least two-thirds of the output duration, rounded up to a whole second.
- 480p: approximately $0.0316 / billable second without reference video; $0.0190 with reference video. Official comparison: $0.0352 and $0.0211, respectively. Underlying rates: $3.15 / 1M video tokens without reference video; $1.89 with reference video.
- 720p: approximately $0.0680 / billable second without reference video; $0.0408 with reference video. Official comparison: $0.0756 and $0.0454, respectively. Underlying rates: $3.15 / 1M video tokens without reference video; $1.89 with reference video.

## Start a Seedance 2.0 Mini project

### Compose with Seedance 2.0 Mini

Use Seedance 2.0 Mini with a short prompt or a prepared opening image. Choose the framing and duration, then review the request so the first result answers a specific creative question.

### Bring a tested brief into code

The Seedance 2.0 Mini documentation shows how to submit a video request and retrieve its result. Keep the model name and selected settings with each saved task for later comparison.

## Shape the scene with Seedance 2.0 Mini

### Text guides the environment

Tell Seedance 2.0 Mini what moves and what should stay still. The park example combines falling leaves with a gentle push-in, leaving the bench as a stable point of reference.

### Give Seedance 2.0 Mini an opening image

Supply a first frame when the scene should begin with a specific composition. Add a last frame when the endpoint matters. These frame controls use a separate mode from mixed reference inputs.

### Multiple references carry distinct roles

Give Seedance 2.0 Mini an image for appearance and a clip for motion when words are insufficient. Identify the role of each reference and avoid contradictory sources that make the intended result ambiguous.

### Audio supports the atmosphere

Seedance 2.0 Mini can generate sound alongside video. Describe wind, footsteps or speech as needed, and check the audio against the scene. Switch it off when the clip will receive its soundtrack later.

## Short briefs for Seedance 2.0 Mini

### Ambient background studies

Explore a quiet location with Seedance 2.0 Mini: leaves moving, light shifting or water rippling. Review the clip for distracting changes before placing text or other elements over it.

### Product atmosphere concepts

Use a reference image to establish the object and describe the environment separately. Check labels, outlines and reflections throughout the result before using it in a product presentation.

### Simple editorial inserts

Create a brief establishing scene with Seedance 2.0 Mini for an edited sequence. Plan a clear starting and ending composition so the shot can fit between existing footage.

## Prepare a Seedance 2.0 Mini scene

### Define the stable element

Before using Seedance 2.0 Mini, identify what viewers must recognize. In the park sample, the bench anchors the scene; changes to its shape would distract from the falling leaves.

### Guide movement with Seedance 2.0 Mini

Describe one source of movement for Seedance 2.0 Mini first. Add a second only when its purpose is clear, and avoid asking a short clip to resolve several unrelated events.

### Set a useful comparison

Keep the Seedance 2.0 Mini prompt, references, aspect ratio and audio setting fixed when comparing another variant. Match duration and resolution before interpreting differences in cost or result quality.

### Inspect the transitions

Watch Seedance 2.0 Mini at full size from opening to end. Check for popping objects, unintended cuts and changing textures, then revise the specific instruction responsible for an unusable shot.

## Integrate Seedance 2.0 Mini

Use the Seedance 2.0 Mini integration guide for the exact model identifier, supported request fields and reference constraints. Submit the prepared request once, save the task ID and retrieve its status until completion. The guide includes an example response and the video download workflow.
Seedance 2.0 Mini supports text, first and last frames, and image, video and audio references, with output at 480p, 720p. Generate up to 15 seconds per request. [Model details and Playground](/models/seedance-2-0-mini).

## Connect to Wan API

Use `https://api.wanapi.app` as the API base URL. Create a key with the **Seedance** model family in [API key settings](/settings/apikeys) and send it as `Authorization: Bearer YOUR_API_KEY`. Keep keys on your server. Playground uses your website session and charges the same account balance; it does not require pasting a key into the browser.

Access requires an enabled account with sufficient balance. `GET /v1/models` lists the models available to your key. Seedance models use `POST /v1/videos`; select the model in the JSON body.

| Setting | Seedance 2.0 Mini |
| --- | --- |
| Model ID | `bytedance/seedance-2.0-mini` |
| `resolution` | `480p`, `720p`; default: `720p`. |
| `duration` | 4–15 output seconds, or `-1` for automatic; default: `5`. |
| `aspectRatio` | `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`; default: `adaptive`. |
| `generateAudio` | `true` by default. `false` does not reduce the token rate. |
| Output | One video per request, at 24 fps. |

The [request fields](#request-fields) describe all 13 top-level fields. Use the field names shown here, including `aspectRatio` and `generateAudio`.

## Submit a Seedance 2.0 Mini task

This is a four-second text-to-video request at 720p. Set `WAN_API_KEY` to your Seedance key on the server. Submit once and save the returned `id`.

```bash
curl https://api.wanapi.app/v1/videos \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true
}'
```

## Query a Seedance 2.0 Mini task

Save the returned `id` as `TASK_ID`, then query with the same key. Submission returns a task receipt; the video is available after completion. Begin polling every five seconds; see [task statuses and downloads](#poll-and-download-the-video).

```bash
curl "https://api.wanapi.app/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"
```

## Seedance 2.0 Mini pricing

Rates are in USD per one million video tokens. Input and output video tokens determine the final cost. Resolution, duration and reference video inputs affect usage; use the matching rate for requests with or without reference video. Audio has no separate price tier.



[View Seedance 2.0 Mini pricing and estimates](/models/seedance-2-0-mini#pricing). Review the estimate in the [Playground](/models/seedance-2-0-mini#playground) before submitting.

## Request fields

Send a JSON object. `model` is required, together with a non-empty prompt or at least one media input. Other fields are optional. Unknown fields are rejected.

| Field | Type | Contract |
| --- | --- | --- |
| `model` | string | Required: `bytedance/seedance-2.0-mini`. |
| `prompt` | string | Text instructions; up to 20,000 characters on this service. A prompt or media input is required. |
| `image` | URL or URL object | First-frame image URL, or an object with `type: "url"`, `url` and optional `mediaType`. Use `image` or `frameImages`, not both. |
| `frameImages` | array | One `first_frame` and an optional `last_frame`. Each entry has `frameType` and `image`; see the frame example below. |
| `inputReferences` | array | Up to 9 images and 3 videos. Each entry has `type: "url"`, `url` and `mediaType`. The `data`/`mediaType` URL form is also accepted. |
| `aspectRatio` | string | `adaptive` (default), `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`. |
| `resolution` | string | `480p`, `720p`. Default: `720p`. Also accepts `854x480`, `1280x720` as resolution tiers; use `aspectRatio` to select the shape. |
| `duration` | integer | 4–15 output seconds, or `-1` for automatic. Default: `5`. |
| `fps` | integer | Fixed at `24`; omit or send `24`. |
| `seed` | integer | Optional; `-1` to `2147483647`. No repeatability guarantee. Do not also specify `providerOptions.bytedance.seed`. |
| `generateAudio` | boolean | Generate audio. Default: `true`; disabling it does not change the token rate. |
| `n` | integer | Fixed at `1`; one video per request. |
| `providerOptions` | object | Optional `bytedance` object: `referenceAudio` (up to 3 HTTP(S) URLs), `seed` (same bounds as top-level `seed`). `draft: true` is not supported. Unknown options are rejected. |

### Input combinations and media limits

- Use `image` for a first frame, or `frameImages` for a first frame and optional last frame. A last frame alone and duplicate frame types are rejected.
- Frames cannot be combined with `inputReferences` or `providerOptions.bytedance.referenceAudio`.
- Reference mode accepts up to 9 images, 3 videos and 3 audio clips, with at most 15 references in total.

- Media inputs must be public HTTP(S) URLs. Upload bytes and credential-bearing URLs are not accepted.
- Images: JPEG, PNG, WebP, BMP, TIFF or GIF; below 30 MB; each side 300–6000 pixels; aspect ratio 0.4–2.5.
- Videos: MP4 or MOV; at most 50 MB per file; each clip 2–15 seconds and at most 15 seconds combined; 300–6000 pixels per side, aspect ratio 0.4–2.5, 24–60 fps.
- Audio: MP3 or WAV; at most 15 MB per file; each clip 2–15 seconds and at most 15 seconds combined. At least one reference image or video is required.
- Remote media size, encoding and duration are checked during processing; URL validation alone cannot guarantee that a file is usable.
- Draft-to-final rendering from an earlier task and arbitrary native task options are not exposed by this endpoint.

## Frame and reference examples

Send these bodies to the same `POST /v1/videos` endpoint. Replace every `example.com` URL with your own directly accessible media URL before submitting. Keep input URLs available until the task finishes.

### First and last frames

For a single first frame, use `image: "https://example.com/first-frame.jpg"` and omit `frameImages`. To set both endpoints of the clip, use:

```json
{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "The camera slowly moves from the opening scene to the closing scene.",
  "frameImages": [
    {
      "frameType": "first_frame",
      "image": "https://example.com/first-frame.jpg"
    },
    {
      "frameType": "last_frame",
      "image": "https://example.com/last-frame.jpg"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": 4
}
```

### Image, video and audio references

Put image and video inputs in `inputReferences`, with an explicit MIME type. Put audio URLs in `providerOptions.bytedance.referenceAudio`. Do not add frame inputs to this request.

```json
{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "Use the character from the image and the camera movement from the video.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/character.jpg",
      "mediaType": "image/jpeg"
    },
    {
      "type": "url",
      "url": "https://example.com/motion.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "providerOptions": {
    "bytedance": {
      "referenceAudio": [
        "https://example.com/sound.wav"
      ]
    }
  },
  "resolution": "720p",
  "duration": 4
}
```

## Poll and download the video

An accepted task returns an object like this. Example IDs and timestamps are illustrative:

```json
{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1792022400
}
```

Poll `GET /v1/videos/{task_id}` with your API key. The query returns the same public task ID and model. Use `status` to decide when to stop polling; `progress` is not an estimate of remaining time.

| Status | Meaning | Next step |
| --- | --- | --- |
| `queued` | The task has been accepted. | Continue polling. |
| `in_progress` | Generation is running. | Continue polling. |
| `completed` | The video is ready. | Read `videos[0].url` and download. |
| `failed` | Generation failed. | Stop polling and inspect `error`. |

A completed query includes `videos`, an array of objects containing `url` and `mediaType`. Timestamps use Unix seconds; `completed_at` appears when completion is recorded.

```json
{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-mini",
  "status": "completed",
  "progress": 100,
  "created_at": 1792022400,
  "completed_at": 1792022460,
  "videos": [
    {
      "url": "/v1/tasks/task_EXAMPLE/artifacts/video/content",
      "mediaType": "video/mp4"
    }
  ]
}
```

When the returned URL is a relative path, resolve it against `https://api.wanapi.app` and authenticate with your API key. For the example above:

```bash
curl "https://api.wanapi.app/v1/tasks/$TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -o video.mp4
```

If a signed HTTPS media URL is returned, use it directly without forwarding your API key to that host. Result URLs can expire. Save videos you want to keep to your own storage. Polling and downloading an existing result do not create another generation.

A failed task includes an `error` object with `code` and `message`, for example:

```json
{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-mini",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}
```

## Billing and failure handling

The final charge follows actual video token usage and the current model rate. The Playground estimate is a maximum estimate, not a fixed quote. Longer clips and larger output resolutions can increase token usage. Failed requests are not charged.

- **Invalid parameters:** correct the fields or input combination before submitting again. Check media formats and limits as well as URL syntax.
- **Authentication or model access:** use a valid Seedance key enabled for the requested model.
- **Insufficient balance:** add funds before a new paid request. A key limit does not add account credit.
- **Temporary polling failure:** retry the GET with backoff and a maximum waiting period. A failed query does not mean the generation failed.
- **Submission timeout or missing task ID:** the outcome may be unknown. Do not automatically repeat the POST; it could create a second paid task.
- **Download failure:** retry the existing result before starting a new generation.

Keep the task ID and contact [support](/contact) if an uncertain submission needs investigation.

[Download the Seedance 2.0 Mini OpenAPI schema](https://wanapi.app/models/seedance-2-0-mini/openapi.json).


## Before choosing Seedance 2.0 Mini

- Seedance 2.0 Mini offers 480p and 720p only, without Draft mode. It does not inherit the standard model’s 1080p and 4K output options.
- Seedance 2.0 Mini requires an image or video alongside reference audio. Reference video clips must total no more than fifteen seconds; the same combined-duration limit applies separately to audio.
- Seedance 2.0 Mini may alter text, fine textures or object geometry while generating motion. Wan API does not expose editing, extension or a separate final-frame image through this integration.

## Seedance 2.0 Mini questions

### Is Seedance 2.0 Mini a standard-model setting?

No. Seedance 2.0 Mini is a separate model with its own identifier and pricing. Select it explicitly in your request; lowering the standard model’s resolution does not switch to Mini.

### Does Mini mean it is always cheaper for my project?

Seedance 2.0 Mini has a separate rate table, but project cost also depends on duration, input video and how many attempts produce usable shots. Check live pricing and compare like-for-like briefs before budgeting.

### What output can I request?

Seedance 2.0 Mini produces MP4 at 24 fps, at 480p or 720p. Choose an integer duration from four to fifteen seconds or automatic duration. Five seconds and 720p are the defaults.

### Can I combine frames with reference audio?

No. Seedance 2.0 Mini frame mode cannot be combined with the reference collection. For audio references, use reference mode with at least one reference image or video and check the per-type limits.

### Does this sample prove it is better than Fast?

No. The Seedance 2.0 Mini park scene and Fast dog scene use different briefs. They show individual results. A meaningful comparison needs the same inputs, settings and acceptance criteria.

[Seedance 2.0 Fast vs Mini: which should you test?](https://wanapi.app/blog/seedance-2-0-fast-vs-mini)

[Official model page](https://docs.byteplus.com/en/docs/ModelArk/2291680)
[Release announcement](https://docs.byteplus.com/en/docs/ModelArk/1159178)