Seedance API

Code examples

Set your key first: export SUME_API_KEY=.... Each example prints the video's URL when it is ready; copy the file, because provider links can expire.

# The parentheses keep an error from closing your terminal if you paste this.
(
  # Start the job. This is the call that costs money.
  RESPONSE=$(curl -sS -X POST https://api.sume.com/v1/video-router/generate \
    -H "Authorization: Bearer $SUME_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: $(uuidgen)" \
    -d '{
      "model": "seedance-2",
      "prompt": "A glass of iced coffee on a wooden table, condensation running down the glass, slow push-in, soft morning light",
      "resolution": "480p",
      "duration": 4,
      "aspect_ratio": "16:9",
      "mode": "async"
    }')
  JOB_ID=$(echo "$RESPONSE" | jq -r '.data.job.id // empty' 2>/dev/null)
  if [ -z "$JOB_ID" ]; then echo "Could not start the job: $RESPONSE" >&2; exit 1; fi
  echo "Job: $JOB_ID"

  # Wait for it. If this stops, read the same job again: don't start a new one.
  while true; do
    JOB=$(curl -sS https://api.sume.com/v1/jobs/$JOB_ID -H "Authorization: Bearer $SUME_API_KEY")
    STATUS=$(echo "$JOB" | jq -r '.data.job.status // empty' 2>/dev/null)
    case "$STATUS" in
      completed) echo "$JOB" | jq -r '.data.job.result.artifacts[0].url'; exit 0 ;;
      failed|canceled) echo "Job $JOB_ID $STATUS: $(echo "$JOB" | jq -c '.data.job.error')" >&2; exit 1 ;;
      queued|processing) sleep 5 ;;
      *) echo "Could not read job $JOB_ID: $JOB" >&2; exit 1 ;;
    esac
  done
)

import json, os, time, urllib.request, uuid

API = "https://api.sume.com"
HEADERS = {"Authorization": "Bearer " + os.environ["SUME_API_KEY"], "Content-Type": "application/json"}

def call(path, body=None, headers={}):
    data = None if body is None else json.dumps(body).encode()
    request = urllib.request.Request(API + path, data=data, headers={**HEADERS, **headers})
    with urllib.request.urlopen(request) as response:
        return json.load(response)["data"]

# Start the job. This is the call that costs money.
job_id = call("/v1/video-router/generate", {
    "model": "seedance-2",
    "prompt": "A glass of iced coffee on a wooden table, condensation running down the glass, slow push-in, soft morning light",
    "resolution": "480p",
    "duration": 4,
    "aspect_ratio": "16:9",
    "mode": "async"
}, {"Idempotency-Key": str(uuid.uuid4())})["job"]["id"]
print("Job:", job_id)

# Wait for it. If this loop stops, read the same job again: don't start a new one.
while True:
    job = call("/v1/jobs/" + job_id)["job"]
    if job["status"] == "completed":
        print(job["result"]["artifacts"][0]["url"])
        break
    if job["status"] in ("failed", "canceled"):
        raise SystemExit(job["error"])
    time.sleep(5)

// Save this as video.mjs and run it with Node 20 or newer: node video.mjs
const API = "https://api.sume.com";
const headers = { Authorization: `Bearer ${process.env.SUME_API_KEY}`, "Content-Type": "application/json" };

async function call(path, init) {
  const response = await fetch(API + path, { headers, ...init });
  const json = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(json.error));
  return json.data;
}

// Start the job. This is the call that costs money.
const { job: started } = await call("/v1/video-router/generate", {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "model": "seedance-2",
    "prompt": "A glass of iced coffee on a wooden table, condensation running down the glass, slow push-in, soft morning light",
    "resolution": "480p",
    "duration": 4,
    "aspect_ratio": "16:9",
    "mode": "async"
  }),
});
console.log("Job:", started.id);

// Wait for it. If this loop stops, read the same job again: don't start a new one.
while (true) {
  const { job } = await call(`/v1/jobs/${started.id}`);
  if (job.status === "completed") {
    console.log(job.result.artifacts[0].url);
    break;
  }
  if (job.status === "failed" || job.status === "canceled") throw new Error(JSON.stringify(job.error));
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

Seedance 2.0 API price

Per second of video

Per clip, or in the provider's own unit

In a provider's own credits

Seedance 2.5 API price

Per second of video

Per clip, or in the provider's own unit

Questions

Is there an official Seedance API?

Yes. ByteDance sells it through BytePlus ModelArk outside China and Volcengine in China. The resellers in the tables below sell it pay-as-you-go.

Is the Seedance 2.0 API free?

No. We found no free API tier: BytePlus's launch page lists paid plans, and the resellers charge per second or per clip. Our Seedance 2.0 page covers the free credits on Dreamina, which is a website rather than an API.

Which Seedance model should I call?

Seedance 2.5 costs more per second than 2.0 at the same resolution: $0.2312 / s against $0.1538 / s at 720p on Sume. Use 2.5 when you need clips over 15 seconds. To call it, change the model to seedance-2.5.

Which provider should I use for the Seedance API?

Compare the tables below for the resolution you need. We use Sume because it is the API Glidezo runs on, not because it is the cheapest for every option. On Replicate, 720p Seedance 2.0 costs $0.18 / s, and on fal $0.3034 / s.

How long does a Seedance API call take?

It's a job, not an instant answer: you start it, then read its status until it finishes. Don't start the job again because your wait timed out, or you may pay twice. Read the same job id again instead.