Seedance Video API

Die Seedance-Videogenerierung verwendet eine asynchrone Video API. Sende zuerst einen Auftrag und frage danach seinen Status mit der zurückgegebenen Task-ID ab. Diese API ist von Chat Completions getrennt.

Vorbereitung

Erstelle einen Modelflare API-Key und verwende https://modelflare.dev/v1 als Base URL. Die öffentlichen Modellnamen sind seedance-2.0 und seedance-2.5.

Verfügbare Kombinationen aus Dauer und Auflösung können je nach Modell abweichen. Prüfe vor der Anfrage Modelle & Preise. Falls unterstützt, lauten die Auflösungen 480p, 720p, 1080p oder 4k.

Text-zu-Video-Anfrage

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Eine weiße Katze läuft im Regen durch eine neonbeleuchtete Straße, filmische Kamerafahrt",
    "duration": 4,
    "resolution": "720p"
  }'

Bild-zu-Video-Anfrage

Füge unter image eine öffentlich erreichbare HTTPS-Bild-URL hinzu. Die übrigen Felder entsprechen der Text-zu-Video-Anfrage.

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Das Motiv dreht sich langsam zur Kamera, während diese vorwärts fährt",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

Antwort beim Senden

Eine erfolgreiche Übermittlung liefert eine öffentliche Task-ID. id und task_id bezeichnen denselben Auftrag; speichere einen der Werte.

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

Task-Status abfragen

Frage den Status alle paar Sekunden ab. Wartezustände können queued, pending, processing oder in_progress sein. Beende die Abfrage bei completed oder failed.

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Beispiel einer abgeschlossenen Antwort:

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Ergebnis herunterladen

Lade das Video nach Abschluss über den content-Endpunkt herunter:

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

Wichtigste Anfragefelder

• model: erforderlich; seedance-2.0 oder seedance-2.5.
• prompt: erforderliche Beschreibung des Videos.
• duration: erforderlich; ganze Sekunden, derzeit mindestens 4. seconds wird ebenfalls akzeptiert.
• resolution: erforderliche, vom gewählten Modell unterstützte Auflösung.
• image: optionale öffentliche HTTPS-Bild-URL; aktiviert Bild-zu-Video.

HTTP 400 weist meist auf ungültige Parameter hin, 401 auf einen ungültigen API-Key und 429 auf ein temporäres Limit. 5xx-Fehler können mit wachsender Wartezeit wiederholt werden.