Seedance 2.0 API Dokumentation

Vollständiger Leitfaden zur Integration der Seedance 2.0 Videogenerierungs-API in Ihre Anwendungen.

API v1.0 Base URL: https://seedanceapi.org/v1

Schnellstart

bash

curl -X POST 'https://seedanceapi.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8"
  }'

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem Bearer-Token im Authorization-Header.

Wichtig: Sie können Ihren API-Schlüssel von der API-Keys-Seite in Ihrem Dashboard erhalten. → API-Schlüssel erhalten

http

Authorization: Bearer YOUR_API_KEY

Preise

480p

480p Auflösung

Schnelle Generierung, geeignet für Vorschauen und Entwürfe

Dauer	Ohne Audio	Mit Audio
4s	8 credits ($0.04)	14 credits ($0.07)
8s	14 credits ($0.07)	28 credits ($0.14)
12s	19 credits ($0.095)	38 credits ($0.19)

720p

720p Auflösung

Hohe Qualität, empfohlen für Produktion

Dauer	Ohne Audio	Mit Audio
4s	14 credits ($0.07)	28 credits ($0.14)
8s	28 credits ($0.14)	56 credits ($0.28)
12s	42 credits ($0.21)	84 credits ($0.42)

API-Endpunkte

POST/v1/generateNeues Video erstellen

Neue Videoerstellungs-Aufgabe mit dem Seedance 2.0 Modell erstellen. Unterstützt Text-zu-Video und Bild-zu-Video.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
`prompt`	string	Erforderlich	Textbeschreibung des zu erstellenden Videos (max. 2000 Zeichen)
`aspect_ratio`	string	Optional	Ausgabeseitenverhältnis. Unterstützt: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (Standard: 1:1)
`resolution`	string	Optional	Videoauflösung: "480p" oder "720p" (Standard: 720p)
`duration`	string	Optional	Videodauer in Sekunden: "4", "8" oder "12" (Standard: 8)
`generate_audio`	boolean	Optional	KI-Audiogenerierung für das Video aktivieren (Standard: false)
`fixed_lens`	boolean	Optional	Kamera fixieren, um Bewegungsunschärfe zu reduzieren (Standard: false)
`image_urls`	string[]	Optional	Array von Referenzbild-URLs für Bild-zu-Video (max. 1)
`callback_url`	string	Optional	Webhook-URL für asynchrone Statusbenachrichtigungen. Muss öffentlich erreichbar sein.

Text zu Video

json

{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

Bild zu Video

json

{
  "prompt": "The character slowly turns and smiles at the camera",
  "image_urls": [
    "https://example.com/my-image.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "4"
}

Mit Audiogenerierung

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

Antworten

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

GET/v1/statusAufgabenstatus abrufen

Status einer Videoerstellungs-Aufgabe prüfen und Ergebnis nach Abschluss abrufen.

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`task_id`	string	Erforderlich	Die eindeutige Aufgaben-ID vom Generate-Endpunkt

Beispielanfrage

bash

curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Das response-Feld in der Status-API ist ein Array von Video-URLs. Sie können direkt auf data.response[0] zugreifen.

javascript

// Extract video URL from response
const videoUrl = data.response[0];

Antworten

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

API-Spielplatz

Testen Sie die API direkt in Ihrem Browser. Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel.

API-PlaygroundPOST

Basis-URL

Endpunkt

Header

Request-Body

Fehlercodes

Status	Code	Description
400 Ungültige Anfrage	`INVALID_PROMPT`	Der Prompt ist ungültig oder leer
400 Ungültige Anfrage	`INVALID_ASPECT_RATIO`	Nicht unterstütztes Seitenverhältnis
400 Ungültige Anfrage	`INVALID_RESOLUTION`	Auflösung muss 480p oder 720p sein
400 Ungültige Anfrage	`INVALID_DURATION`	Dauer muss 4, 8 oder 12 Sekunden sein
400 Ungültige Anfrage	`TOO_MANY_IMAGES`	Maximal 1 Bild-URL im image_urls-Array erlaubt
401 Nicht autorisiert	`INVALID_API_KEY`	API-Schlüssel fehlt oder ist ungültig
402	`INSUFFICIENT_CREDITS`	Nicht genügend Credits für diesen Vorgang
404 Nicht gefunden	`TASK_NOT_FOUND`	Aufgaben-ID nicht gefunden oder gehört nicht zu Ihrem Konto
500 Interner Serverfehler	`INTERNAL_ERROR`	Serverfehler, bitte versuchen Sie es später erneut