cicora.ai
Deutsch (Österreich)
API-SpezifikationAsynchrone Medien

Video

Starten Sie die Videogenerierung als asynchronen Auftrag, speichern Sie die Auftrags-ID und halten Sie Erstellung und Abruf des Ergebnisses getrennt.

Integrationsreferenz: Wählen Sie Parameter und verfügbare Funktionen in den API-Einstellungen Ihres Kontos und im Modellkatalog für Ihre Umgebung aus.

Auftrag erstellen

Eine Videoanfrage enthält üblicherweise Eingabe, Modell und Bildeigenschaften wie Dauer, Seitenverhältnis, Auflösung oder Referenzen, jedoch nur, wenn das gewählte Modell sie unterstützt.

Speichern Sie die Auftrags-ID sofort. Sie wird benötigt, um Fortschritt anzuzeigen, einen Abbruch in Ihrer Oberfläche zu ermöglichen und den endgültigen Inhalt abzurufen.

Videogenerierungsauftrag
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Status abfragen

  • Lesen Sie einen Auftrag über GET /videos/{video_id}.
  • Behandeln Sie den Endstatus als maßgebliche Quelle für den Abschluss.
  • Verwenden Sie ein zunehmendes Abfrageintervall und stoppen Sie es, wenn der Benutzer die Seite verlässt.

Mit dem Ergebnis arbeiten

Verwenden Sie nach Abschluss die vom Auftrag zurückgegebene URL oder den Inhalt und prüfen Sie die Dateibereitschaft, bevor Sie einen Player anzeigen.

Speichern Sie Eingabe, Modell, Parameter und Auftrags-ID für den Support, bewahren Sie Eingabereferenzen aber nicht länger auf, als Ihr Produkt es erfordert.

Fortfahren mit