Skip to main content
POST

Authentifizierung

string
erforderlich
Alle APIs erfordern die Authentifizierung mit einem Bearer Token.API-Schlüssel abrufen:Rufen Sie die API-Schlüsselverwaltung auf, um Ihren API-Schlüssel zu erhalten.Fügen Sie ihn dem Anfrageheader hinzu:

Anfrageparameter

string
erforderlich
Name des Videogenerierungsmodells. Muss gemini-omni-1.1-flash sein.
string
Textanweisung. Beschreiben Sie bei Text-zu-Video die Szene und bei Bild-zu-Video, Videobearbeitung oder -fortsetzung die Bewegung, den Stil oder die gewünschte Änderung.
Geben Sie mindestens prompt oder Medien (image_urls, Start-/Endbilder oder video_urls) an.
string
Standard:"720p"
Auflösung des Ausgabevideos. Groß-/Kleinschreibung wird nicht berücksichtigt.Verfügbare Werte:
  • 360p
  • 720p (Standard)
  • 1080p
  • 4k
2160p wird als 4k behandelt. Die Auflösung bestimmt die Höhe der Vorabreservierung und die wesentlichen Kosten der Videoausgabe.
Eine nicht unterstützte Auflösung führt zum Fehler invalid_resolution.
string
Standard:"16:9"
Seitenverhältnis des Videos zur Auswahl von Quer- oder Hochformat.Unterstützt:
  • 16:9 – Querformat (Standard)
  • 9:16 – Hochformat
Andere Werte werden als 16:9 behandelt.
Wenn video_urls angegeben ist, übernimmt die Ausgabe normalerweise das Seitenverhältnis des Eingabevideos; aspect_ratio ist dann möglicherweise wirkungslos.
array<string>
Array mit Referenzbildern. Unterstützt werden nur öffentlich erreichbare HTTP/HTTPS-URLs.
  • 1 Bild: wird standardmäßig als Startbild des Videos verwendet
  • Mehrere Bilder: dienen als Motiv- oder Stilreferenzen; beschreiben Sie Zweck und Beziehung der Bilder in prompt
image_urls und Start-/Endbilder dürfen zusammen höchstens 10 Bilder enthalten.
string
Startbild. Unterstützt wird nur eine öffentlich erreichbare HTTP/HTTPS-URL.
  • Allein angegeben: verwendet das Bild als Startbild des Videos
  • Mit last_frame_image angegeben: erzeugt einen fließenden Übergang vom Start- zum Endbild
string
Endbild. Unterstützt wird nur eine öffentlich erreichbare HTTP/HTTPS-URL; es muss zusammen mit first_frame_image angegeben werden.
Wird nur last_frame_image angegeben, wird invalid_frame_images zurückgegeben. Verwenden Sie für beide Bilder dasselbe Seitenverhältnis und stimmen Sie es auf aspect_ratio ab.
Für ein Startbild oder ein Start-/Endbildpaar sind die folgenden Methoden gleichwertig. Wählen Sie eine davon und geben Sie nicht beide an:
  • first_frame_image / last_frame_image verwenden
  • image_with_roles verwenden und role auf first_frame / last_frame setzen
array<object>
Array mit Bildern und Rollen. Dies ist eine gleichwertige Alternative zu first_frame_image / last_frame_image und kann auch Referenzbilder deklarieren.Beispiel:
Wenn zusätzlich image_urls angegeben ist, hat es für Referenzbilder Vorrang und wird nicht mit Referenzen in image_with_roles kombiniert. Insgesamt dürfen höchstens 10 Bilder einschließlich Start- und Endbild verwendet werden.
array<string>
Array mit Videos zur Bearbeitung oder Fortsetzung. Derzeit ist höchstens ein Video mit maximal 10 Sekunden Länge erlaubt.Unterstützt werden nur öffentlich erreichbare direkte HTTP/HTTPS-Video-URLs. YouTube-Links werden nicht unterstützt.
video_urls und extend_from_task_id schließen sich gegenseitig aus. Geben Sie nur eines an.
object
Objekt mit Zusatzparametern zur expliziten Angabe der Generierungsabsicht.
Bei der Interpolation von Start- und Endbild leitet das Modell den Aufgabentyp automatisch ab; die Plattform übergibt metadata.task nicht.
string
Lokale task_id der vorherigen Generierungsaufgabe. Verwenden Sie sie für dialogbasierte Bearbeitung oder weitere Fortsetzung, ohne das vorherige Video erneut hochzuladen.Die referenzierte Aufgabe muss dem aktuellen Benutzer gehören, erfolgreich abgeschlossen sein und ein Gemini-Omni-Modell verwenden.
extend_from_task_id und video_urls schließen sich gegenseitig aus. Geben Sie nur eines an.
Dieses Modell besitzt keinen Parameter duration. Die Dauer jeder Ausgabe wird inhaltsabhängig automatisch bestimmt und beträgt normalerweise 3–10 Sekunden. Beschreiben Sie das gewünschte Tempo in prompt in natürlicher Sprache oder mit Zeitbereichen.

Antwort

integer
Antwortstatuscode. Bei Erfolg 200.
array
Zurückgegebenes Aufgabenarray.

Aufgabenergebnis abrufen

Die Videogenerierung läuft asynchron. Verwenden Sie nach Erhalt der task_id die API Aufgabenstatus abrufen, um Fortschritt und Ergebnis abzufragen.
cURL
Fragen Sie alle 5–10 Sekunden ab und beenden Sie die Abfrage bei completed oder failed. Für den gesamten Client wird ein Timeout von 10 Minuten empfohlen.

Beispiel für ein erfolgreiches Ergebnis

Anwendungsfälle

Anwendungsfall 1: Text-zu-Video (4K)

Anwendungsfall 2: Interpolation von Start- und Endbild

Anwendungsfall 3: Referenzen mehrerer Motive

Anwendungsfall 4: Start- und Endbild über Bildrollen

Anwendungsfall 5: Videobearbeitung

Verwenden Sie für die Videobearbeitung kurze, eindeutige Prompts. Wenn nur ein Teil geändert werden soll, fügen Sie Keep everything else the same hinzu, um den übrigen Inhalt konsistent zu halten.

Anwendungsfall 6: Dialogbasierte Fortsetzung