NewMiniMax H3 Lite is live: our cheapest video model, at a launch price until Dec 31. Try it free

OG filename: how-to-use-seedance-api-cover-v3.png
All guides
How-to

How to Use the Seedance API in 2026

Generate Seedance 2.0 and 2.5 videos with sound from your own code with the AiWings API: create a key, send one request, and get a permanent MP4 link. Step by step, in cURL, JavaScript and Python.

·6 min read·

How to Use the Seedance API in 2026

Want Seedance videos in your own app, script or automation? This guide shows how to make them with the AiWings API, step by step. You use one AiWings key, pay per second of video from your AiWings credits, and get back a permanent link to every MP4. It takes about five minutes from no account to a finished video, and the same key also covers MiniMax H3 video and a range of image models.

What you need

  • An AiWings account. Sign in with Google; new accounts get 10 free credits to try AiWings.
  • An AiWings API key, which you create in the next step.
  • Somewhere to run code on a server: a script, a backend route, a serverless function or an automation tool that can send HTTP requests. Keys don’t work from browser or mobile app code, where anyone could read them.

Step 1: Create an API key

  1. 1Sign in to AiWings and open the API page in your dashboard.
  2. 2Click Create key, give it a name (for example “my-app production”) and, if you like, a monthly credit limit.
  3. 3Copy the key. It starts with aiw_live_ and is shown only once.
  4. 4Save it as an environment variable on the machine or service that will call the API.
export AIWINGS_API_KEY="aiw_live_your_key_here"

The API uses the same credits as AiWings in ChatGPT, Claude and the dashboard, so there’s no separate plan to buy. Every request sends the key in the Authorization header as a Bearer token.

Create an API key

Step 2: Choose a Seedance model

Pick the version with the model field. Both make videos with sound and are billed per second. A reference video, a clip the model copies the motion from, uses a higher rate:

Modelmodel valueResolutionsLength5 seconds at 720pWith a reference videoBest for
Seedance 2.0seedance-2.0480p, 720p, 1080p, 4K4–15 seconds115 credits ($1.15)140 credits ($1.40)Short clips up to 4K
Seedance 2.5seedance-2.5480p, 720p4–30 seconds145 credits ($1.45)605 credits ($6.05)Longer clips, big reference sets

Prices are at the top-up rate of $0.01 per credit, and plans include more credits per dollar. Seedance 2.0 at 480p is 10 credits ($0.10) per second, the cheapest way to test a prompt. Each finished video reports exactly what it cost in its credits field, and GET /v1/models lists every price.

Step 3: Make your first video

Send a POST request to /v1/videos with a prompt and the model you picked. This one makes a 5-second 16:9 clip with Seedance 2.0 at 480p, which costs 50 credits ($0.50):

1# 1. Start the job
2curl https://aiwings.io/api/v1/videos \
3 -H "Authorization: Bearer $AIWINGS_API_KEY" \
4 -H "Content-Type: application/json" \
5 -d '{
6 "prompt": "Slow dolly shot of a glass bottle on wet sand at sunset, waves rolling in, seagulls in the distance",
7 "model": "seedance-2.0",
8 "resolution": "480p",
9 "duration": 5,
10 "aspect_ratio": "16:9",
11 "audio": true
12 }'
13
14# 2. Check it until status is "succeeded" (or "failed")
15curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \
16 -H "Authorization: Bearer $AIWINGS_API_KEY"
POST /v1/videosShell

Creating a video returns right away with an id and status "processing". Videos usually take one to a few minutes, so you check back with GET /v1/videos/{id}. Adding ?wait=30 holds each check open for up to 30 seconds and returns the moment the video is ready, so the loop above makes only a handful of requests.

When status is "succeeded", output.url is a permanent link to the MP4. If a video fails, status is "failed", error.message says why, and the credits are refunded automatically. Every video you make through the API also shows up in your AiWings library.

Step 4: Animate an image

To bring a still image to life, pass a public image URL as first_frame and describe only the motion. You can also add last_frame, and Seedance moves from the first picture to the second. Already made the image with AiWings? Pass its id as source_generation_id instead of a URL.

1# 1. Start the job
2curl https://aiwings.io/api/v1/videos \
3 -H "Authorization: Bearer $AIWINGS_API_KEY" \
4 -H "Content-Type: application/json" \
5 -d '{
6 "prompt": "The rocket lifts off slowly, smoke billowing across the launch pad, stars twinkling above",
7 "model": "seedance-2.5",
8 "resolution": "720p",
9 "duration": 5,
10 "first_frame": "https://example.com/rocket-poster.jpg"
11 }'
12
13# 2. Check it until status is "succeeded" (or "failed")
14curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \
15 -H "Authorization: Bearer $AIWINGS_API_KEY"
POST /v1/videosShell

When you give Seedance 2.5 a first frame, the video takes the shape of your image. To guide the look without fixing the first frame, send reference_images instead (up to 9 on Seedance 2.0 and 30 on Seedance 2.5) and mention them in the prompt as [Image1], [Image2] and so on.

Step 5: Copy the motion of a reference video

Only Seedance can follow a reference video: a clip you give it to copy the camera move, motion or editing style from. Pass public MP4 or MOV links as reference_videos. Requests with a reference video use the higher per-second rate, 140 credits ($1.40) for 5 seconds of Seedance 2.0 at 720p.

1# 1. Start the job
2curl https://aiwings.io/api/v1/videos \
3 -H "Authorization: Bearer $AIWINGS_API_KEY" \
4 -H "Content-Type: application/json" \
5 -d '{
6 "prompt": "A white sneaker on a turntable, filmed with the same camera move as the reference clip",
7 "model": "seedance-2.0",
8 "resolution": "720p",
9 "duration": 5,
10 "reference_videos": [
11 "https://example.com/orbit-shot.mp4"
12 ]
13 }'
14
15# 2. Check it until status is "succeeded" (or "failed")
16curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \
17 -H "Authorization: Bearer $AIWINGS_API_KEY"
POST /v1/videosShell

Reference images and first and last frames can’t be combined in one request, so pick one approach per video. If a combination isn’t allowed, the error message says exactly what to change.

See what Seedance can make

Real, unedited results. Each original image is on the left, and the video Seedance 2.5 made from it is on the right. Seedance adds sound too; it is muted here.

The original 1980s sci-fi poster
The original 1980s sci-fi posterImage
Animated with Seedance 2.5Seedance 2.5 · 5s
The original sneaker blueprint
The original sneaker blueprintImage
Animated with Seedance 2.5Seedance 2.5 · 5s

More models with the same key

Your key isn’t limited to Seedance. The same key, balance and request format cover every video and image model on AiWings. To switch, change the model field: video models go to POST /v1/videos and image models to POST /v1/images.

Modelmodel valueEndpointFrom
Seedance 2.0seedance-2.0/v1/videos50 credits ($0.50) for 5 seconds at 480p
Seedance 2.5seedance-2.5/v1/videos65 credits ($0.65) for 5 seconds at 480p
MiniMax H3minimax-h3/v1/videos50 credits ($0.50) for 5 seconds at 768p
MiniMax H3 Highspeedminimax-h3-highspeed/v1/videos20 credits ($0.20) for 5 seconds at 768p
MiniMax H3 Liteminimax-h3-lite/v1/videos10 credits ($0.10) for 5 seconds at 480p
GPT Image 2.6 Flaregpt-image-2.6-flare/v1/images7 credits ($0.07) per image
GPT Image 2.6 Sunburstgpt-image-2.6-sunburst/v1/images7 credits ($0.07) per image
GPT Image 2.5 Flaregpt-image-2.5-flare/v1/images2 credits ($0.02) per image
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst/v1/images2 credits ($0.02) per image
GPT Image 2gpt-image-2/v1/images2 credits ($0.02) per image
GPT Image 1.5gpt-image-1.5/v1/images2 credits ($0.02) per image
Nano Banananano-banana/v1/images5 credits ($0.05) per image
Nano Banana 2nano-banana-2/v1/images8 credits ($0.08) per image
Nano Banana Pronano-banana-pro/v1/images19 credits ($0.19) per image
Seedream 5 Liteseedream-5-lite/v1/images5 credits ($0.05) per image
Grok Imaginegrok-imagine/v1/images3 credits ($0.03) per image
Flux Fastflux-fast/v1/images1 credit ($0.01) per image

GET /v1/models returns the same list with every price, size and option, so your code can check what’s available instead of hard-coding it.

See every model with samples

Things to know

  • Seedance generates synced sound, including speech, music and effects. Send "audio": false for a silent video.
  • Videos can be 4 to 15 seconds on Seedance 2.0 and up to 30 seconds on Seedance 2.5.
  • Aspect ratios: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21 on Seedance 2.0.
  • Send an Idempotency-Key header with each new job (the JavaScript and Python examples do). If a request times out and you retry with the same key, you get the same job back instead of paying twice.
  • Each key has its own rate limit, and you can give each key a monthly credit cap so a bug in one app can’t spend your whole balance.
  • Output URLs are public but unguessable, like a share link. Download the file to your own storage if you need to control who can see it.

If something goes wrong

  • 401 authentication_failed: the key is missing, mistyped or revoked. Check the Authorization header reads Bearer followed by your key.
  • 400 invalid_request: a field isn’t allowed for that model, for example a resolution or length it doesn’t support. The error’s param names the field to fix.
  • 402 insufficient_credits: your balance can’t cover the video. Top up in the dashboard and send the request again.
  • 403 spend_limit_reached: this key hit its monthly credit limit. Raise or remove the limit on the API page.
  • 429 rate_limited or too_many_jobs: you’re sending too fast or have too many jobs rendering at once. Wait for the Retry-After time, or for a video to finish.
  • The video failed with a content error: the prompt or image was blocked by the model’s safety filter. Reword it; the credits were already refunded.

Bottom line

You don’t need a separate account with each model maker to put Seedance in your product. One AiWings key gives your code Seedance 2.0 and 2.5, MiniMax H3 and the image models, billed from one balance, with permanent links and automatic refunds on failures. Prefer no code? The same models work in ChatGPT and Claude.

Read the full API reference

FAQ

Is this the official Seedance API?

No. AiWings is an independent service that runs Seedance for you. You use an AiWings key and AiWings credits, with no separate ByteDance account or billing.

How much does a Seedance video cost through the API?

It’s billed per second. A 5-second clip is 50 credits ($0.50) with Seedance 2.0 at 480p and 115 credits ($1.15) at 720p. A reference video raises the rate. Failed videos are refunded.

Seedance 2.0 or 2.5?

Seedance 2.0 for short clips at up to 4K. Seedance 2.5 for clips up to 30 seconds and large reference sets of up to 30 images.

Can I use it from n8n, Make or Zapier?

Yes, any tool that can send an HTTP request works. Send the POST request from Step 3, then check the video with a GET request until its status is succeeded.

Can the same key make images?

Yes. POST /v1/images makes images with GPT Image, Nano Banana, Seedream, Flux and more, from the same key and balance.