Eine Video-API auswählen
Ein Seedance-Video erstellen
Seedance-Video-Tasks erstellen.
Ein HappyHorse-Video erstellen
HappyHorse-Text-zu-Video-Jobs erstellen.
Ein Sora 2-Video erstellen
Sora 2-Video-Jobs erstellen.
Ein Sora 2-Video abrufen
Sora-Video-Jobs abfragen.
Ein Veo 3-Video erstellen
Veo-Video-Jobs erstellen.
Ein Wan-Video erstellen
Wan-Text-zu-Video-Jobs erstellen.
Ein xAI-Video erstellen
xAI-Video-Jobs generieren.
Ein Vidu-Video erstellen
Vidu-Text-zu-Video-Jobs erstellen.
Ein Omni-Video erstellen (Beta)
Beta-Omni-Video-Jobs erstellen.
Einen Kling-Text-zu-Video-Task erstellen
Kling-Videos aus Text-Prompts generieren.
Einen Runway-Bild-zu-Video-Task erstellen
Runway-Videos aus Bildern generieren.
Erstellen und Abfragen einer Video-Task
Verwenden Sie eine videofähige model ID von der Models page oder aus dem model directory. Die folgenden Beispiele erstellen mitPOST /v1/videos eine Video-Task und fragen dann die zurückgegebene Task-ID ab, bis die Task einen Endzustand erreicht.
Diese Beispiele verwenden den Platzhalter
your-video-model-id. Ersetzen Sie ihn vor dem Ausführen der Anfrage durch eine verfügbare Video-model ID von der Models page oder dem model directory.Antwortbeispiele
Eine erfolgreiche Antwort auf das Erstellen kann wie folgt aussehen. Speichern Sie die Task-ID, bevor Sie die Abfrage starten:video_url enthalten; einige Provider-Formate verwenden modellspezifische Ergebnisfelder oder die Route für Videoinhalte, wenn diese Route dokumentiert ist:
Beispielhafte model-Datensätze
Diese Beispielantwort des Modellkatalogs zeigt den Envelope von
/api/models und die Form eines Video-Modelldatensatzes. Sie ist keine vollständige Modellliste.cURL
Häufige Fehler
Fehlende task ID
Fehlende task ID
Speichere die ID aus der Erstellungsantwort, bevor dein Job-Handler zurückkehrt.
Zu schnelles Polling
Zu schnelles Polling
Füge zwischen den Statusprüfungen eine Verzögerung und Backoff hinzu.
Nicht unterstützte Dauer oder Größe
Nicht unterstützte Dauer oder Größe
Verwende die Felder für duration und resolution, die für den ausgewählten Video-Endpunkt dokumentiert sind.
Fehlende `video_url`
Fehlende `video_url`
Behandle
video_url als optional und greife auf modellspezifische Ergebnisfelder oder die content-Route zurück, wenn verfügbar.Callback nicht empfangen
Callback nicht empfangen
Nutze Polling als Source of Truth und überprüfe, dass deine Callback-URL POST-Anfragen akzeptiert.
Fehlercodes und Retry-Strategie
400
400
Nicht erneut versuchen, bis die Felder für Prompt, Dateien, duration oder size korrigiert wurden.
401
401
Nicht erneut versuchen, bis der API-Schlüssel vorhanden und gültig ist.
404
404
Prüfe task ID, Basis-URL, Pfad und model ID, bevor du es erneut versuchst.
413
413
Reduziere die Upload-Größe, bevor du es erneut versuchst.
429
429
Versuche es mit exponentiellem Backoff erneut und reduziere die Parallelität bei Erstellung oder Polling.
500 or 503
500 or 503
Versuche die Task-Erstellung mit Backoff erneut; pollende bestehende Tasks weiter, es sei denn, die Task erreicht einen terminalen Fehler.
Preise und Modellverzeichnis
Modellseite
Lies nach, wie CometAPI model IDs in der Dokumentation bereitstellt.
Modellverzeichnis
Durchsuche Modellverfügbarkeit und Fähigkeiten.
Preise
Prüfe die Preise, bevor du ein Modell aufrufst.