Generează videoclipuri și imagini din propriile tale instrumente

Ghid rapid

1. 1

   Creează o cheie

   Generează o cheie API în dashboard-ul tău. Se afișează o singură dată, așa că păstreaz-o într-un loc sigur.

   Gestionează cheile
2. 2

   Apelează API-ul

   Trimite o cerere POST cu cheia ta Bearer și un antet 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

   Sondează rezultatul

   Interoghează endpoint-ul stării sarcinii până când starea este finalizată sau eșuată, apoi citește rezultatul.

   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

Autentificare

Fiecare cerere este autentificată cu o cheie API Bearer în antetul 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_"
    }
  ]
}

coduri de eroare

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.

Utilizare cu Claude Code

Folosește Copy for AI pentru a exporta întregul API ca Markdown curat, lipește-l în Claude Code sau Codex și lasă agentul să conecteze integrarea. Sau direcționează agentul direct către endpoint-ul de text brut.

Skill

Instalează skill-ul Seedance în Claude Code, Codex, sau orice agent — scrie prompt-uri cinematice și le redă prin API pentru tine.

# 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

Întrebări frecvente

Cine poate folosi API-ul?

Oricine are credite. Nu există restricții de abonament — orice cont cu credite poate crea o cheie și poate apela API-ul.

Cum obțin credite?

Încarcă sau abonează-te pe pagina de prețuri. Creditele se adaugă instantaneu în soldul tău.

Creditele sunt partajate între site și API?

Da — soldul tău personal de credite acoperă atât generarea pe web, cât și apelurile API. Într-o echipă, apelurile API folosesc soldul personal al fiecărui membru, nu fondul comun al echipei.

Cum încep?

Creează o cheie API în panoul tău de control, apoi apelează endpoint-urile cu un token Bearer (vezi Quickstart mai sus).

Ce se întâmplă dacă un apel returnează insufficient_credits?

Soldul tău este gol — încarcă pe pagina de prețuri și încearcă din nou.