Videos und Bilder mit Ihren eigenen Tools generieren

Schnellstart

1. 1

   Schlüssel erstellen

   Generieren Sie einen API-Key in Ihrem Dashboard. Er wird nur einmal angezeigt, bewahren Sie ihn daher sicher auf.

   Schlüssel verwalten
2. 2

   API aufrufen

   Senden Sie eine POST-Anfrage mit Ihrem Bearer-Schlüssel und einem 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

   Ergebnis abrufen

   Fragen Sie den Task-Status-Endpunkt ab, bis der Status „abgeschlossen“ oder „fehlgeschlagen“ ist, und lesen Sie dann die Ausgabe.

   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

Authentifizierung

Jede Anfrage wird mit einem Bearer-API-Schlüssel im Authorization-Header authentifiziert.

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

Fehlercodes

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.

Mit Claude Code verwenden

Mit Copy for AI exportieren Sie die vollständige API als sauberes Markdown, fügen es in Claude Code oder Codex ein und lassen den Agenten die Integration einrichten. Oder Sie verweisen den Agenten direkt auf den Roh-Text-Endpunkt.

Skill

Installieren Sie die Seedance-Fertigkeit in Claude Code, Codex oder einen beliebigen Agenten – sie schreibt filmreife Prompts und rendert diese automatisch über die API für Sie.

# 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

Wer kann die API nutzen?

Jeder mit Credits. Es gibt keine Planbeschränkung – jedes Konto mit Credits kann einen Schlüssel erstellen und die API aufrufen.

Wie bekomme ich Credits?

Laden Sie Guthaben auf oder abonnieren Sie auf der Preisseite. Guthaben wird Ihrem Konto sofort gutgeschrieben.

Werden Credits zwischen der Website und der API geteilt?

Ja – Ihr persönliches Guthaben wird sowohl für die Web-Generierung als auch für Ihre API-Aufrufe verwendet. In einem Team verwenden API-Aufrufe das persönliche Guthaben jedes Mitglieds, nicht das gemeinsame Team-Guthaben.

Wie starte ich?

Erstellen Sie einen API-Key in Ihrem Dashboard und rufen Sie dann die Endpoints mit einem Bearer-Token auf (siehe Quickstart oben).

Was passiert, wenn ein Aufruf `insufficient_credits` zurückgibt?

Ihr Guthaben ist leer – laden Sie auf der Preisseite auf und versuchen Sie es erneut.