Zum Hauptinhalt springen
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-1.2-flash-ext gesetzt.
string
erforderlich
Videobeschreibung oder Bearbeitungsanweisung. Darf nach dem Entfernen führender und nachgestellter Leerzeichen nicht leer sein. Beschreiben Sie bei Text-zu-Video Szene, Figuren, Handlung, Kamera und Ton; mit Bildern oder Videos beschreiben Sie Bewegung, Stil oder die gewünschten Änderungen.Beispiel: "Aerial shot over a misty mountain lake at sunrise."
prompt ist in allen Modi erforderlich, auch bei Startbild, Mehrbild-Referenz, Bearbeitung und Verlängerung. Fehlt der Parameter, wird ein 400-Fehler zurückgegeben.
integer
Standard:"10"
Videodauer in Sekunden. Muss eine ganze Zahl sein.
  • Text-zu-Video / Startbild / Mehrbild-Referenz: Ausgabedauer, 3–15
  • Start- und Endbild: Ausgabedauer, 3–10
  • Verlängerung (extend): Dauer des neu hinzugefügten Abschnitts, 3–10
  • Bearbeitung (edit): darf nicht übergeben werden; die Ausgabedauer entspricht dem Quellvideo
Der Alias seconds wird ebenfalls akzeptiert. Werden beide übergeben, müssen die Werte übereinstimmen.
Wird duration im Bearbeitungsmodus übergeben, wird der Fehler video edit does not accept duration zurückgegeben.
string
Standard:"720p"
Videoauflösung, ohne Beachtung der Groß-/Kleinschreibung. Sie bestimmt den Preis pro Sekunde.Zulässige Werte:
  • 360p
  • 720p
  • 1080p
  • 4k (2160p wird ebenfalls akzeptiert)
Jede andere Auflösung führt zu einem 400-Fehler.
string
Standard:"16:9"
Nur 16:9 (Querformat, Standard) und 9:16 (Hochformat) werden unterstützt; andere Werte führen zu einem 400-Fehler.
string
Aufgabentyp, der festlegt, wie das Eingabematerial verwendet wird.Zulässige Werte:
  • edit - Video bearbeiten; zusammen mit video_urls oder extend_from_task_id verwenden
  • extend - Video verlängern, indem am Ende neuer Inhalt angefügt wird; zusammen mit video_urls oder extend_from_task_id verwenden
  • reference - Mehrbild-Referenz; zusammen mit image_urls verwenden
  • text_to_video / image_to_video / reference_to_video - Text-zu-Video / Startbild / Referenzbilder
  • auto - wird anhand der Eingabe erkannt; mit Video wird es als edit behandelt
Ohne Video optional; der Modus wird anhand der Eingabe erkannt.
Bei Übergabe von video_urls oder extend_from_task_id ist ein Aufgabentyp erforderlich (omni_reference_task_type oder das kompatible Feld generation_type); fehlt er, wird ein 400-Fehler zurückgegeben. Empfohlen wird die explizite Angabe von edit oder extend; auto wird als edit behandelt.
string
Kompatibilitätsfeld, gleichwertig mit omni_reference_task_type. Zulässige Werte: frame (entspricht image_to_video), reference, edit, extend.
generation_type und omni_reference_task_type dürfen nicht gleichzeitig übergeben werden.
array<url>
Array mit Referenzbildern für die Mehrbild-Referenz (Figuren, Produkte, Stile usw.). Unterstützt 1–10 Bilder.Es werden nur öffentlich erreichbare HTTP/HTTPS-Bild-URLs unterstützt. Laden Sie lokale Bilder zuerst hoch, um eine öffentliche URL zu erhalten, und übergeben Sie diese; Base64-Data-URLs werden derzeit nicht unterstützt und führen zu einem 400-Fehler.Wird nur 1 Bild übergeben, hängt die Verwendung vom Aufgabentyp ab:
  • omni_reference_task_type nicht angegeben: wird als Referenzbild verwendet
  • omni_reference_task_type ist auto oder image_to_video: wird als Startbild verwendet
Für die Generierung ab Startbild empfiehlt es sich, direkt first_frame_image zu verwenden, statt sich auf die Anzahl der Bilder zu verlassen.
image_urls darf nicht zusammen mit first_frame_image oder last_frame_image übergeben werden, und Bilder in image_urls werden nie als Startbild behandelt; beim Bearbeiten und Verlängern dürfen keine Bilder übergeben werden.
string
Startbild: Das erste Bild des generierten Videos ist dieses Bild. Es werden nur öffentlich erreichbare HTTP/HTTPS-Bild-URLs unterstützt, keine Base64-Data-URLs.Zusammen mit last_frame_image übergeben, wird ein Video aus Start- und Endbild generiert.
string
Endbild für die Generierung aus Start- und Endbild; das Video geht vom Startbild in dieses Bild über. Es werden nur öffentlich erreichbare HTTP/HTTPS-Bild-URLs unterstützt, keine Base64-Data-URLs.Im Start-/Endbild-Modus:
  • duration unterstützt 3–10; 10 Sekunden, wenn nicht angegeben
  • system_prompt und negative_prompt dürfen nicht übergeben werden
last_frame_image muss zusammen mit first_frame_image übergeben werden; wird nur das Endbild übergeben, folgt der Fehler last_frame_image requires first_frame_image. Eine Kombination mit image_urls ist nicht möglich.
array<object>
Bild-Array mit Rollen, eine gleichwertige Schreibweise für first_frame_image / last_frame_image / image_urls.
array<url>
Array mit dem zu bearbeitenden oder zu verlängernden Video; es wird nur 1 Video unterstützt. Alternativ kann das Einzelwertfeld video_url verwendet werden – übergeben Sie nur eines von beiden.Es werden nur öffentlich erreichbare HTTP/HTTPS-Video-URLs unterstützt. Format MP4 / MOV / WebM, höchstens 15 Sekunden und 64 MB.
Bei Übergabe von video_urls ist ein Aufgabentyp erforderlich; empfohlen wird omni_reference_task_type mit edit oder extend (auto wird als edit behandelt). Fehlt er, wird ein 400-Fehler zurückgegeben. Werden 2 oder mehr Videos übergeben, wird ein 400-Fehler zurückgegeben.
string
Eine Task-ID dieser Plattform (task_01…). Damit können Sie eine Ihrer zuvor abgeschlossenen gemini-omni-1.2-flash-ext-Aufgaben weiter bearbeiten oder verlängern, ohne das Video erneut hochzuladen.Voraussetzungen:
  • Die Aufgabe gehört zum aktuellen Konto
  • Das Modell der Aufgabe ist gemini-omni-1.2-flash-ext
  • Der Status der Aufgabe ist completed
  • Der Kanal, über den die ursprüngliche Aufgabe erstellt wurde, ist weiterhin verfügbar; andernfalls wird 503 source_channel_unavailable zurückgegeben
  • Das ursprüngliche Ergebnis ist höchstens 15 Sekunden lang (gilt für Bearbeitung und Verlängerung); im Bearbeitungsmodus muss zudem seine Dauer ermittelbar sein
Ist der Kanal nicht verfügbar oder lässt sich die Dauer des ursprünglichen Ergebnisses nicht ermitteln, laden Sie es herunter und laden Sie es stattdessen über video_urls hoch. Ist das ursprüngliche Ergebnis länger als 15 Sekunden, kürzen Sie es vor dem Hochladen auf höchstens 15 Sekunden.
extend_from_task_id darf nicht zusammen mit video_urls übergeben werden, und ein Aufgabentyp ist erforderlich; empfohlen wird omni_reference_task_type mit edit oder extend (auto wird als edit behandelt).
string
Inhalte, die nicht im Video erscheinen sollen.Beispiel: "people, cars, color"
Im Start-/Endbild-Modus darf negative_prompt nicht übergeben werden.
string
Systemanweisung, etwa um einen visuellen Stil festzulegen oder eingeblendeten Text zu verbieten. Muss ein String sein.Beispiel: "Render as a black-and-white silent film."
Im Start-/Endbild-Modus darf system_prompt nicht übergeben werden.

Antwort

integer
Statuscode der Antwort. Erfolgreiche Anfragen geben 200 zurück.
array
Zurückgegebenes Task-Array.

Aufgabenergebnis abfragen

Die Videogenerierung läuft asynchron. Nach dem Einreichen wird eine task_id zurückgegeben. Fragen Sie Fortschritt und Ergebnis über die API Aufgabenstatus abrufen ab.
cURL
Fragen Sie alle 5-10 Sekunden ab und setzen Sie das Client-Timeout auf mindestens 10 Minuten. Richtwerte für die Generierungsdauer (inklusive Warteschlange): etwa 46 Sekunden für ein 15-Sekunden-Video in 360p, etwa 99 Sekunden für 15 Sekunden in 1080p und etwa 4-5 Minuten für 15 Sekunden in 4k. Der Fortschritt kann bis zum Abschluss lange bei 10 % stehen bleiben.

Beispiel für ein erfolgreiches Ergebnis

Die Video-URL ist data.result.videos[0].url[0]. data.actual_time ist die Bearbeitungszeit der Aufgabe in Sekunden, nicht die Videolänge. Die Ausgabe ist MP4 (H.264, 24fps) mit AAC-Tonspur und unsichtbarem SynthID-Wasserzeichen; bei 4k fehlt gelegentlich die Tonspur.

Beispiel für ein fehlgeschlagenes Ergebnis

Fehlgeschlagene Aufgaben werden vollständig erstattet.

Abrechnung

Abrechnung pro Sekunde: Kosten = Sekundenpreis der gewählten Auflösung × abgerechnete Sekunden. Alle Modi werden in der angeforderten Auflösungsstufe abgerechnet. Die tatsächlichen Preise finden Sie auf der Preisseite.

Anwendungsfälle

Szenario 1: Text-zu-Video

Szenario 2: Video ab Startbild

Szenario 3: Video aus Start- und Endbild

Im Start-/Endbild-Modus unterstützt duration 3–10 Sekunden (10 Sekunden, wenn nicht angegeben); system_prompt / negative_prompt dürfen nicht übergeben werden.

Szenario 4: Mehrbild-Referenz

Szenario 5: Videobearbeitung

Übergeben Sie beim Bearbeiten kein duration; die Ausgabedauer entspricht dem Quellvideo.

Szenario 6: Videoverlängerung

Szenario 7: Bestehende Aufgabe verlängern

Szenario 8: Systemanweisung und Negativ-Prompt