Skip to main content
POST
Veo 3.1 Bild-zu-Video
Die API der Veo 3.1 Preview-Version ist automatisch mit dieser Schnittstelle kompatibel.
Verwenden Sie das Videogenerierungsmodell Veo 3.1, um durch Eingabe eines Bildes und einer Textbeschreibung hochwertige Videoinhalte zu erstellen. Diese Schnittstelle verarbeitet Anfragen asynchron; das endgültige Generierungsergebnis muss über die task_id abgefragt werden.

Anforderungsheader

string
erforderlich
Enumerationswert: application/json
string
erforderlich
Bearer-Authentifizierungsformat: Bearer {{API Key}}.

Anforderungstext

string
erforderlich
Eine Textzeichenfolge, die das Video beschreibt, das Sie generieren möchten.
string
Eingabebild; unterstützt URL oder base64-kodierte Eingabe.
string
Abschlussbild, das zum Füllen des letzten Frames des Videos verwendet wird. Unterstützt URL oder base64-kodierte Eingabe.
object[]
Eine Liste mit bis zu drei asset-Bildern oder bis zu einem style-Bild, die Referenzbilder beschreiben, die das Modell beim Generieren des Videos verwendet.
string
Gibt das Seitenverhältnis des generierten Videos an.Enumerationswerte: 16:9, 9:16. Der Standardwert ist 16:9.
integer
Die Länge der Videodatei, die Sie generieren möchten, in Sekunden.Enumerationswerte: 4, 6, 8; bei Verwendung von reference_images ist nur 8 möglich.Der Standardwert ist 8.
boolean
Gibt an, ob Gemini verwendet werden soll, um Ihren Prompt zu verbessern. Es wird nur true unterstützt.Standardwert: true
boolean
erforderlich
Gibt an, ob Audio für das Video generiert werden soll.
string
Eine Textzeichenfolge, die beschreibt, welche Inhalte das Modell nicht generieren soll.
string
Sicherheitseinstellung, die steuert, ob die Generierung von Personen oder Gesichtern erlaubt ist.Enumerationswerte:
  • allow_adult (Standard): Erlaubt nur die Generierung von Erwachsenen
  • dont_allow: Erlaubt keine Personen oder Gesichter im Bild
  • allow_all: Erlaubt die Generierung von Personen aller Altersgruppen (das Projekt muss in der allowlist enthalten sein)
string
Die Auflösung des generierten Videos.Enumerationswerte: 720p (Standard) oder 1080p
integer
Die Anzahl der zu generierenden Videobeispiele.Wertebereich: 1-4
uint32
Eine Zahl zur Initialisierung des Zufallsgenerierungsprozesses. Die Verwendung desselben Seeds, Prompts und derselben anderen Parameter erzeugt dasselbe Ausgabevideo, wodurch der Generierungsprozess deterministisch wird.Wertebereich: 0-4,294,967,295

Antwortparameter

string
erforderlich
Die task_id der asynchronen Aufgabe. Verwenden Sie diese task_id, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das Generierungsergebnis abzurufen.