Genereer video's en afbeeldingen met je eigen tools

Snel aan de slag

1. 1

   Sleutel aanmaken

   Genereer een API-sleutel in je dashboard. Deze wordt slechts één keer getoond, dus bewaar hem op een veilige plek.

   Beheer sleutels
2. 2

   API aanroepen

   Stuur een POST-verzoek met je Bearer key en een Idempotency-Key-header.

   cURLJavaScriptPython

   Copy

   curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
     -H "Authorization: Bearer $SEEDANCE_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: demo-video-001" \
     -d '{
       "mode": "text-to-video",
       "quality_tier": "standard",
       "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
       "aspect_ratio": "16:9",
       "duration": "5",
       "resolution": "720p"
     }'

3. 3

   Resultaat opvragen

   Bevraag het taakstatus-eindpunt totdat de status 'voltooid' of 'mislukt' is, en lees dan de uitvoer.

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

Authenticatie

Elk verzoek wordt geauthenticeerd met een Bearer API-sleutel in de Authorization-header.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://www.seedance2ai.io/api/v1/balance" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

curl "https://www.seedance2ai.io/api/v1/models" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

Foutcodes

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

Gebruik met Claude Code

Gebruik Copy for AI om de volledige API als nette Markdown te exporteren, plak deze in Claude Code of Codex en laat de agent de integratie opzetten. Of wijs de agent direct naar het raw-text-endpoint.

Skill

Installeer de Seedance-skill in Claude Code, Codex of een andere agent — hij schrijft filmische prompts en rendert ze voor je via de API.

# Download the one-file skill from Seedance 2.0 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Veelgestelde vragen

Wie kan de API gebruiken?

Iedereen met credits. Er is geen planbeperking — elk account met credits kan een sleutel aanmaken en de API aanroepen.

Hoe krijg ik credits?

Waardeer op of abonneer je op de prijzenpagina. Credits worden direct aan je saldo toegevoegd.

Worden credits gedeeld tussen de website en de API?

Ja — je persoonlijke creditsaldo wordt gebruikt voor zowel webgeneratie als API-aanroepen. In een team gebruiken API-aanroepen het eigen persoonlijke creditsaldo van elk lid, niet de gedeelde teampool.

Hoe begin ik?

Maak een API-sleutel aan in je dashboard en roep de endpoints aan met een Bearer-token (zie Quickstart hierboven).

Wat als een call insufficient_credits retourneert?

Je saldo is leeg — laad op via de prijzenpagina en probeer het opnieuw.