Skapa video och bilder med dina egna verktyg

Snabbstart

1. 1

   Skapa en nyckel

   Skapa en API-nyckel i din dashboard. Den visas en gång, så förvara den på en säker plats.

   Hantera nycklar
2. 2

   Anropa API

   Skicka en POST-förfrågan med din Bearer-nyckel och en 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

   Avfråga resultatet

   Polla statusändpunkten för uppgiften tills status är slutförd eller misslyckad, läs sedan utdata.

   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

Autentisering

Varje begäran autentiseras med en Bearer API-nyckel i Authorization-headern.

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_"
    }
  ]
}

Felkoder

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.

Använd med Claude Code

Använd Copy for AI för att exportera hela API:t som ren Markdown, klistra in det i Claude Code eller Codex och låt agenten koppla ihop integrationen. Eller peka agenten direkt mot råtext-endpointen.

Skill

Installera Seedance-skillen i Claude Code, Codex eller vilken agent som helst — den skriver filmiska prompts och renderar dem via API:et åt dig.

# 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

Vanliga frågor

Vem kan använda API:et?

Alla med krediter. Det finns ingen planbegränsning — alla konton med krediter kan skapa en nyckel och anropa API:et.

Hur får jag krediter?

Ladda på eller prenumerera på prissidan. Krediterna läggs till ditt saldo omedelbart.

Delas krediter mellan webbplatsen och API:et?

Ja — din personliga kreditbalans används både för din webbgenerering och dina API-anrop. I ett team använder API-anrop varje medlems egen personliga balans, inte den gemensamma team-potten.

Hur börjar jag?

Skapa en API-nyckel i din dashboard och anropa sedan endpoints med en Bearer-token (se Quickstart ovan).

Vad händer om ett anrop returnerar insufficient_credits?

Ditt saldo är tomt — fyll på via prissidan och försök igen.