Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungHolen Sie Ihren API Key:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API Key zu erhaltenIm Anfrage-Header hinzufügen:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsVerfügbare Modelle:
  • veo3.1-fast-official — Veo 3.1 Official Fast
  • veo3.1-quality-official — Veo 3.1 Official High Quality
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Positiver Text-PromptBeschreiben Sie Szenen, Aktionen, Stile usw. ausführlich für bessere Generierungsergebnisse. Englische Prompts werden empfohlen.Beispiel: "a golden retriever running on the beach, sunset, cinematic"
string
Negativer Prompt zum Ausschließen unerwünschter InhalteBeispiel: "blurry, low quality, watermark, text"
integer
Standard:"8"
Videodauer in SekundenEmpfohlene Werte: 4 / 6 / 8Standard: 8Hinweis: Muss eine reine Zahl sein (z. B. 8), keine Anführungszeichen hinzufügen, sonst tritt ein Fehler auf
string
Standard:"16:9"
Seitenverhältnis des VideosVerfügbare Werte:
  • 16:9 — Querformat
  • 9:16 — Hochformat
Standard: 16:9
string
Standard:"720p"
VideoauflösungVerfügbare Werte:
  • 720p — Standardauflösung
  • 1080p — Hochauflösung
  • 4K — Ultra-Hochauflösung
Standard: 720p
string
URL des Bildes für den ersten Frame für die Bild-zu-Video-Generierung
  • Die Bild-URL muss öffentlich zugänglich sein, ohne Hotlink-Schutz
  • Es werden URLs aus Objektspeichern statt temporärer Download-Links empfohlen
string
URL des Bildes für den letzten Frame für die Bild-zu-Video-GenerierungWird zusammen mit first_frame_image verwendet, um ersten und letzten Frame zu steuern
integer
Zufalls-Seed zur Reproduktion der GenerierungsergebnisseWertebereich: 04294967295
integer
Standard:"1"
Anzahl der zu generierenden Samples (1-4), derzeit wird empfohlen, 1 zu verwendenStandard: 1
boolean
Standard:"false"
Ob eine Audiospur generiert werden soll
string
Standard:"allow_adult"
Richtlinie zur PersonengenerierungVerfügbare Werte:
  • allow_adult — nur die Generierung erwachsener Personen/Gesichter erlauben
  • disallow — Generierung von Personen oder Gesichtern nicht erlauben
Standard: allow_adult
string
Standard:"pad"
Strategie zur Größenänderung von Bildern (wirksam bei Bild-zu-Video)Verfügbare Werte:
  • pad — Padding-Modus
  • crop — Zuschneide-Modus
Standard: pad
boolean
Standard:"true"
Ob die Upstream-Prompt-Verbesserung aktiviert werden sollStandard: true
  • Dieser Parameter kann nur auf true gesetzt werden. Wird er auf false gesetzt, schlägt die Anfrage fehl
  • Wenn Sie diesen Parameter nicht benötigen, fügen Sie ihn nicht hinzu

Text-zu-Video vs. Bild-zu-Video

Das System bestimmt den Modus automatisch danach, ob Bildparameter übergeben werden: keine Bilder für Text-zu-Video, Bilder für Bild-zu-Video.

Antwort

integer
Antwortstatuscode, 200 bei Erfolg
array
Array der Antwortdaten

Anwendungsszenarien

Szenario 1: Text-zu-Video (einfach)

Szenario 2: Text-zu-Video (vollständige Parameter)

Szenario 3: Bild-zu-Video (nur erster Frame)

Szenario 4: Bild-zu-Video (erster Frame + letzter Frame)

Szenario 5: Video mit Audio

Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die bei der Einreichung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Fortschritt und die Ergebnisse der Generierung abzufragen.