Genera video e immagini dai tuoi strumenti

Avvio rapido

1. 1

   Crea una chiave

   Genera una chiave API nella tua dashboard. Viene mostrata una sola volta, quindi conservala in un posto sicuro.

   Gestisci chiavi
2. 2

   Chiama l'API

   Invia una richiesta POST con la tua chiave Bearer e un header Idempotency-Key.

   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

   Verifica il risultato

   Interroga l'endpoint dello stato dell'attività finché lo stato non è completato o fallito, poi leggi l'output.

   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

Autenticazione

Ogni richiesta viene autenticata con una chiave API Bearer nell'header Authorization.

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

Codici di errore

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.

Usa con Claude Code

Usa Copy for AI per esportare l'intera API come Markdown pulito, incollalo in Claude Code o Codex e lascia che l'agente configuri l'integrazione. Oppure punta l'agente direttamente all'endpoint di testo grezzo.

Skill

Installa la skill Seedance in Claude Code, Codex o qualsiasi altro agente: scrive prompt cinematografici e li renderizza tramite API per te.

# 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

FAQ

Chi può usare l'API?

Chiunque abbia crediti. Non c'è alcun blocco basato sul piano — qualsiasi account con crediti può creare una chiave e chiamare l'API.

Come posso ottenere crediti?

Ricarica o abbonati nella pagina dei prezzi. I crediti vengono aggiunti al tuo saldo istantaneamente.

I crediti sono condivisi tra il sito web e l'API?

Sì — il tuo saldo crediti personale alimenta sia la generazione web sia le chiamate API. In un team, le chiamate API utilizzano il saldo personale di ciascun membro, non quello condiviso del team.

Come faccio a iniziare?

Crea una chiave API nella tua dashboard, poi chiama gli endpoint con un token Bearer (vedi Quickstart sopra).

E se una chiamata restituisce insufficient_credits?

Il tuo saldo è vuoto — ricarica sulla pagina dei prezzi e riprova.