Seedance API: Make Your First Video in Three Calls
Start a Seedance video job, poll it and download the MP4 with plain HTTP. A complete walkthrough with curl and Python, and what each step costs.
Video models do not answer in one request the way chat models do. A video takes one to five minutes to make, so the API runs it as a job: you start it, check on it, and fetch the file when it is done. This post walks through all three calls with a Seedance model, first with curl, then as a short Python script.
You need an API Store account with some balance and an API key from the API keys page. Keys start with sk-.
Step 1: start the job
Send the model, a prompt and, if you like, the length, resolution and aspect ratio to POST /videos:
curl https://api.apistore.cloud/v1/videos \
-H "Authorization: Bearer $APISTORE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
"ratio": "16:9"
}'The answer comes back at once. It carries the id of the job and its status:
{ "id": "video_8f2c...", "status": "queued", "model": "seedance-2.0-mini" }If you leave the optional fields out, you get 5 seconds at 720p in 16:9, with sound. Sound (speech, music and effects) is generated together with the picture; send "audio": false if you do not want it.
Step 2: poll until it is done
Ask for the job every few seconds:
curl https://api.apistore.cloud/v1/videos/video_8f2c... \ -H "Authorization: Bearer $APISTORE_API_KEY"
status moves from queued to in_progress, then ends as completed or failed. A completed job also carries usage.video_tokens and usage.cost_usd, so you know exactly what it cost. A failed job carries error.code and error.message and is not charged.
Step 3: download the file
A completed job has a url: a link to the MP4 that works for a week and is renewed each time you read the job. You can also always fetch the file through the API:
curl -L https://api.apistore.cloud/v1/videos/video_8f2c.../content \ -H "Authorization: Bearer $APISTORE_API_KEY" -o boat.mp4
The same thing in Python
No SDK is needed: the requests package is enough.
import os, time, requests
BASE = "https://api.apistore.cloud/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APISTORE_API_KEY']}"}
job = requests.post(f"{BASE}/videos", headers=HEAD, json={
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
}).json()
while job["status"] not in ("completed", "failed"):
time.sleep(5)
job = requests.get(f"{BASE}/videos/{job['id']}", headers=HEAD).json()
if job["status"] == "failed":
raise SystemExit(f"{job['error']['code']}: {job['error']['message']}")
video = requests.get(f"{BASE}/videos/{job['id']}/content", headers=HEAD)
open("boat.mp4", "wb").write(video.content)
print("cost", job["usage"]["cost_usd"], "USD")What it costs
Video is billed by the video the model actually made. The price depends on the model and the resolution, and the site shows it per second of output. Seedance 2.0 mini at 480p, the cheapest combination today, costs $0.0202 per second, and $0.0454 per second at 720p.
When the job starts, the cost of the longest result it could produce is held from your balance. When it finishes, you pay for what was made and the rest is released. If the job fails, nothing is charged. How video billing works explains the numbers in detail.
Which model to start with
- Seedance 2.0 mini for tests and drafts: the lowest price, 480p and 720p.
- Seedance 2.0 fast when you want better quality at a moderate price.
- Seedance 2.0 for the best picture of the 2.0 family, up to 1080p and 4K.
- Seedance 2.5 for long videos of up to 30 seconds, many reference files, and editing or extending a video.
All four take the same request, so you can switch by changing one word. Choosing a Seedance model compares them side by side.
Next steps
- Give the model a first frame or reference images: see the video docs.
- Try a prompt in the playground before you write code.
- Check the price list for every model and resolution.
