Seedance 2.0 Mini API

Introduction

Seedance 2.0 Mini reference-to-video reconciles several authorised sources into one shot: images for who and what, clips for motion and pacing, audio for the beat the cut lands on. It takes no first frame.

Seedance 2.0 Mini is the smallest tier of ByteDance's Seedance 2.0 line. It publishes the same endpoints as Seedance 2.0 Fast and returns 4 to 15 second clips at 480p or 720p, with audio generated in the same pass.

Choose a Seedance 2.0 Mini mode by starting material

Key features

The same contract as Seedance 2.0 Fast

Mini publishes the same endpoints and the same fields as Seedance 2.0 Fast: adaptive framing plus six fixed ratios, 4 to 15 seconds or -1 for a length the model chooses, native audio and seed, with resolution capped at 720p. A pipeline written against Mini moves to Fast by changing the model id, not the request.

Built for volume

Mini is the tier to pick when throughput matters more than the extra quality of the larger Seedance 2.0 models. Every endpoint is asynchronous: send an Idempotency-Key with each request, store the task ids and let polling or callbacks resolve them. The key is honoured for 24 hours, so a retry after a dropped connection returns the original task.

Longer sequences with Video Extend

To go past fifteen seconds, send a finished clip to the video-extend endpoint: its final frame opens a new Seedance 2.0 Mini shot and you get one file back with both joined.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 9 credits for a 5-second clip ($0.09).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

One reference set for a whole series

Three views of one man from the front, three-quarter and profile, plus a fourth image of his apron, can carry an entire series while only the prompt changes between requests. The published bakery example is built exactly that way.

Pacing borrowed from a clip

A reference clip can supply rhythm instead of content. One example matches an unhurried continuous push from a clip, stages it down an aisle from a reference image and lands the footsteps on the pulse of a reference track, eight seconds in 9:16.

A couple held steady across angles

Three stills of the same couple let a new shot find a third angle while faces and wardrobe stay the same, as in the park-bench example rendered at 480p.

Prompt guide & pro tips

Name each reference by position

The prompt is required and does the casting, because references are read in the order you send them. Write "References 1-3 are..." or use @Image1, @Image2 so that each asset has exactly one job.

Know the ceilings

Send up to 9 images, 3 clips and 3 audio tracks, with at least one image or clip in every request.

Adapt the included example

The published example uses aspect_ratio 16:9, duration_seconds 6, generate_audio true and resolution 720p, with four images in reference_image_urls.

@Image1, @Image2 and @Image3 are the same man from front, three-quarter and profile; @Image4 is his apron. Put him behind the counter of a small bakery at opening time in that apron, sliding a tray into the case and glancing up as the door chimes. Warm ovens, flat morning light.

Three angles hold the face, the fourth image holds the costume, and the prompt says which is which. Keep that split when you cast your own character.

Need an exact first frame? Use image-to-video

This endpoint has no first- or last-frame field. When the opening picture must match a still exactly, send that still to image-to-video and describe only the motion.

API quick start

Call the Seedance 2.0 Mini API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model bytedance/seedance-2.0-mini/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Seedance 2.0 Mini API questions

All Seedance models

Seedance 2.0 Fast has the same settings and is tuned for speed, and full Seedance 2.0 goes up to 4K for delivery.

• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Seedance 2.0 Mini APILightweight Seedance for quick 720p drafts with soundFrom 9 credits for a 5-second clip
• Seedance 2.0 APICinematic clips up to 4K with native audioFrom 33 credits for a 5-second clip
• Seedance 2.0 Fast APIFaster Seedance 2.0 with sound at 720pFrom 17 credits for a 5-second clip
• Seedance 1.5 Pro APINative-audio clips with an optional locked cameraFrom 9 credits for a 5-second clip

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip

More about Seedance 2.0 Mini

Try it

Seedance 2.0 Mini AI Video Generator onlineCreate videos with Seedance 2.0 Mini in PopNow

Docs

Seedance 2.0 Mini model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Seedance 2.0 Mini results without polling