Status und Ergebnis der Seedance-Aufgabe

Die Erstellung von Seedance-Videos erfolgt asynchron. Die Erstellungsanforderung gibt eine Aufgaben-ID zurück; Abfragen von Modelflare, bis die Aufgabe abgeschlossen ist oder fehlschlägt.

Unterstützte Modelle

Erstellen Sie eine Aufgabe

Verwenden Sie die passende Modellseite für den vollständigen Anfragetext:

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

Speichern Sie id aus der Antwort. Kompatibilitätsantworten können task_id verwenden.

Fragen Sie die Aufgabe ab

bash

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

Die öffentliche Reaktion ist bei allen Videoanbietern normalisiert:

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

Umfrage, während status queued oder in_progress ist. Stoppen Sie bei completed oder failed.

Status	Bedeutung	Nächster Schritt
queued	Warte auf Ausführung	Nochmals Umfrage
in_progress	Verarbeitung	Nochmals Umfrage
completed	Video ist fertig	Laden Sie den Inhalt herunter
failed	Aufgabe fehlgeschlagen	Lesen Sie den Fehler und beheben Sie die Anfrage

Wenn die Dienstantwort sie enthält, kann metadata die normalisierte Aktion, Auflösung, Verhältnis, Ausgabeformat, Audio-Flag und Token-Nutzung enthalten. Behandeln Sie diese Felder als optional; Verwenden Sie status und den Inhaltsendpunkt als stabilen Vertrag.

Laden Sie das Ergebnis herunter

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

Der Inhaltsendpunkt gibt den Videostream zurück. Speichern Sie es umgehend, da Ergebnis-URLs ablaufen können.

Fehlgeschlagene Aufgaben

Die Erstellung kann eine Aufgaben-ID zurückgeben, bevor die Anbietervalidierung abgeschlossen ist. Eine spätere Umfrage kann daher die Aufgabe auf failed ändern. Behalten Sie die Anforderungs-ID bei der Fehlersuche bei. Versuchen Sie es nicht noch einmal, indem Sie den Anforderungsumschlag stillschweigend in eine andere Modellfamilie ändern.