Zum Hauptinhalt springen
POST
Gemini Omni 1.2 Flash Text-zu-Video

Autorisierungen

Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Body

application/json
model
enum<string>
Standard:gemini-omni-1.2-flash-text-to-video
erforderlich

Modellname, fest auf gemini-omni-1.2-flash-text-to-video eingestellt

Verfügbare Optionen:
gemini-omni-1.2-flash-text-to-video
Beispiel:

"gemini-omni-1.2-flash-text-to-video"

prompt
string
erforderlich

Text-Prompt für Motiv, Handlung, Szene und Kamerabewegung.

Unterstützt Chinesisch und Englisch. Beschreibe die gewünschte Aktion und die Änderungen klar, um stabilere Ergebnisse zu erhalten. Negative Vorgaben wie No dialogue oder Kein Text direkt in prompt schreiben; es gibt keinen separaten Parameter für negative Prompts.

Der Prompt ist erforderlich und darf weder leer sein noch ausschließlich aus Leerraum bestehen.

Minimum string length: 1
Pattern: \S
Beispiel:

"Eine Glasmurmel rollt schnell über eine Holzbahn und fällt schließlich mit einem Spritzer ins Wasser."

quality
enum<string>
Standard:720p

Videoauflösung; Standard 720p.

Unterstützte Werte:

  • 360p: Querformat 640×360 / Hochformat 360×640
  • 720p: Querformat 1280×720 / Hochformat 720×1280; Standard
  • 1080p: Querformat 1920×1080 / Hochformat 1080×1920
  • 4k: Querformat 3840×2160 / Hochformat 2160×3840

Die Ausrichtung wird durch aspect_ratio bestimmt: 16:9 erzeugt Querformat, 9:16 Hochformat.

Abrechnung: Ausgabe-Token steigen linear mit der Auflösung. Gegenüber 720p benötigt 360p etwa ein Drittel, 1080p etwa das 1,5-Fache und 4k etwa das 3-Fache. Die tatsächliche Abrechnung richtet sich nach der generierten Nutzung.

Verfügbare Optionen:
360p,
720p,
1080p,
4k
Beispiel:

"720p"

duration
integer
Standard:3

Videodauer in Sekunden; Standard 3. Erlaubt sind ganze Zahlen von 3 bis 15. Die Dauer beeinflusst die Abrechnung direkt.

Erforderlicher Bereich: 3 <= x <= 15
Beispiel:

3

aspect_ratio
enum<string>
Standard:auto

Seitenverhältnis: 16:9, 9:16 oder auto; Standard auto.

Verfügbare Optionen:
16:9,
9:16,
auto
Beispiel:

"auto"

seed
integer

Zufalls-Seed; standardmäßig zufällig. Bereich: 0–4294967295. Ein fester Seed reduziert beim Optimieren des Prompts Schwankungen durch Parameteränderungen und verbessert die Reproduzierbarkeit.

Erforderlicher Bereich: 0 <= x <= 4294967295
Beispiel:

42

callback_url
string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

  • Wird ausgelöst, wenn die Aufgabe abgeschlossen (completed), fehlgeschlagen (failed) oder abgebrochen (cancelled) wurde
  • Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

  • Nur HTTPS-Protokoll wird unterstützt
  • Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
  • URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
  • Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
  • Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus
Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Videoaufgabe erfolgreich erstellt

created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757169743

id
string

Aufgaben-ID

Beispiel:

"task-unified-1757169743-7cvnl5zw"

model
string

Tatsächlich verwendeter Modellname

Beispiel:

"gemini-omni-1.2-flash-text-to-video"

object
enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:
video.generation.task
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

status
enum<string>

Aufgabenstatus. Der Erstellungsendpunkt gibt immer processing zurück; auch der interne Status pending wird Clients als processing angezeigt.

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"processing"

task_info
object

Detaillierte Informationen zur Videoaufgabe

type
enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"video"

usage
object

Nutzungs- und Abrechnungsinformationen