Seedance 2.0
Seedance 2.0
DokumentationErste Schritte
API-UeberblickText zu VideoBild zu Video
API-Referenz

API-Ueberblick

Verstehen Sie Authentifizierung, Einreichung, Statusabfrage und Webhooks der Seedance 2.0 Open API.

Mit der Seedance 2.0 Open API koennen Sie asynchrone Videojobs aus Ihrem eigenen Produkt einreichen und das Ergebnis nach Abschluss abrufen.

Base URL

https://www.seedance2.ink

Authentication

Alle Open-API-Anfragen verwenden ein Bearer-Token, das im Seedance-Dashboard erstellt wird.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Ablauf

  1. Erstellen Sie einen API Key im Seedance-Dashboard.
  2. Senden Sie einen Job mit POST /api/open/v1/video/generations.
  3. Speichern Sie die zurueckgegebene requestId.
  4. Pollen Sie GET /api/open/v1/video/generations/{requestId} bis zum Abschluss.
  5. Optional koennen Sie einen Webhook fuer Abschlussmeldungen nutzen.

Zentrale Endpunkte

MethodEndpointDescription
GET/api/open/v1/modelsListet verfuegbare Modelle, Dauern, Seitenverhaeltnisse, Aufloesungen und Preisinformationen.
POST/api/open/v1/video/generationsErstellt einen neuen Videogenerierungsjob.
GET/api/open/v1/video/generations/{requestId}Liest den Status und liefert nach Fertigstellung die Ausgabedatei.
POST/api/open/v1/video/generations/{requestId}/cancelBricht einen wartenden oder laufenden Job ab.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

Statuswerte

StatusDescription
queuedDie Anfrage wurde angenommen und wartet in der Queue.
processingDer Job wird aktuell verarbeitet.
succeededDer Job wurde erfolgreich abgeschlossen, output.url ist verfuegbar.
failedDer Job ist fehlgeschlagen. Pruefen Sie error.
cancelledDer Job wurde vor Abschluss abgebrochen.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhooks

Sie koennen webhookUrl pro Anfrage setzen oder eine Standard-Callback-URL am API Key hinterlegen.

  • Wenn beides vorhanden ist, hat die Anfrage-spezifische webhookUrl Vorrang.
  • Mit konfiguriertem Webhook Secret wird x-seedance-signature mitgesendet.
  • Webhooks werden nur bei Endstatus versendet.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Fehlercodes

HTTP statusError codeDescription
400invalid_requestDer Request-Body entspricht nicht dem erwarteten Schema.
401unauthorizedDer API Key ist ungueltig oder fehlt.
402insufficient_creditsEs sind nicht genug Credits vorhanden.
404not_foundDer Job wurde fuer den aktuellen API Key nicht gefunden.
429rate_limitedDas Minutenlimit oder Monatskontingent wurde ueberschritten.
500internal_errorEin unerwarteter Serverfehler ist aufgetreten.

Naechste Schritte

  • Text zu Video lesen
  • Bild zu Video lesen

Erste Schritte

Der schnellste Weg, mit Seedance 2.0 produktiv zu werden.

Text zu Video

Erzeugen Sie Videos aus Text-Prompts mit der Seedance 2.0 Open API.

Inhaltsverzeichnis

Base URLAuthenticationAblaufZentrale EndpunkteAvailable ModelsStatuswerteModels Endpoint ExampleWebhooksFehlercodesNaechste Schritte