Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Anfragen erfordern eine Authentifizierung per Bearer Token.API-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhalten.Fügen Sie beim Senden von Anfragen den folgenden Header hinzu:

Anfrageparameter

string
erforderlich
Name des Videogenerierungsmodells, fest auf gemini-omni-flash-preview gesetzt.
string
erforderlich
Textanweisung. Bei Text-to-Video eine Szenenbeschreibung; bei Image-/Video-to-Video eine Anweisung zu Aktion / Stil / Bearbeitung.
prompt und Referenzmaterial (image_urls / video_urls) müssen mindestens eines von beiden angegeben werden.
array<string>
Referenzbilder, maximal 16 Bilder. Jedes Element ist eine http(s)://-URL.Unterstützt JPEG / PNG. Bei mehreren Subjekten (z. B. „Katze + Wollknäuel”) können mehrere Bilder übergeben und im prompt beschrieben werden, wie sie interagieren.
array<string>
Referenz- / zu bearbeitendes Video, maximal 1 (mehrere Videoreferenzen werden nicht unterstützt). Kann ein http(s)://-Direktlink oder data:video/... sein.
  • Das Referenzvideo dauert 1 bis 24 Sekunden, offiziell empfohlen werden ≤3 Sekunden.
  • video_urls und extend_from_task_id schließen sich gegenseitig aus; geben Sie nur eines von beiden an, nicht beide gleichzeitig.
string
Standard:"16:9"
Seitenverhältnis des Videos, steuert tatsächlich die Ausrichtung der Ausgabe.
Wenn video_urls übergeben wird, hat der Parameter aspect_ratio keine Wirkung.
Unterstützt werden nur:
  • 16:9 - Querformat (Standard)
  • 9:16 - Hochformat
Andere Werte werden als 16:9 behandelt.
string
Standard:"720p"
Videoauflösung. Derzeit wird nur 720p unterstützt.
string
Vorherige Task-ID: Geben Sie die** task_id** der vorherigen Generierungsaufgabe an.
extend_from_task_id und video_urls schließen sich gegenseitig aus; geben Sie nur eines von beiden an, nicht beide gleichzeitig.

Antwort

integer
Statuscode der Antwort, bei Erfolg 200.
array
Zurückgegebenes Task-Array.

Aufgabenergebnis abfragen

Die Videogenerierung erfolgt asynchron. Nach der Einreichung wird eine task_id zurückgegeben. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis der Generierung abzufragen.

Beispiel für ein erfolgreiches Ergebnis

Anwendungsfälle

Szenario 1: Text-to-Video

Szenario 2: Image-to-Video

Szenario 3: Video-to-Video