Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • viduq3-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
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
Textprompt, maximal 2000 ZeichenErforderlich für Text-to-Video. Optional für Image-to-Video und den Modus „Erstes + letztes Bild”.Beispiel: "A cat playing piano, camera slowly zooms in"
integer
Standard:"5"
Videodauer (Sekunden)Bereich: 1 bis 16Standard: 5
string
Standard:"720p"
Auflösung des VideosOptionen:
  • 540p — Standardauflösung
  • 720p — HD (Standard)
  • 1080p — Full HD
Standard: 720p
string
Seitenverhältnis des Videos (nur für den Text-to-Video-Modus)Optionen:
  • 16:9 — Querformat
  • 9:16 — Hochformat
  • 4:3 — Traditionell
  • 3:4 — Traditionelles Hochformat
  • 1:1 — Quadrat
Dieser Parameter ist nur im Text-to-Video-Modus verfügbar (wenn image_urls nicht angegeben ist).
array<url>
Array mit Bild-URLs für die Image-to-Video-GenerierungDas System bestimmt den Generierungsmodus automatisch anhand der Anzahl der Bilder:
  • 0 Bilder (nicht angegeben): Text-to-Video-Modus
  • 1 Bild: Image-to-Video-Modus (das Bild wird als Startbild verwendet)
  • 2 Bilder: Modus „Erstes + letztes Bild” (erstes Bild = erstes Bild, zweites Bild = letztes Bild)
Beispiel: ["https://example.com/photo.jpg"]
  • Maximal 2 Bilder unterstützt
  • Für den Modus „Erstes + letztes Bild” müssen genau 2 Bilder bereitgestellt werden
  • Wenn image_urls angegeben ist (egal ob 1 oder 2 Bilder), kann der Parameter aspect_ratio nicht verwendet werden — das Seitenverhältnis wird automatisch durch das Bild bestimmt
boolean
Standard:"true"
Ob Audio (Dialoge, Soundeffekte) erzeugt werden sollStandard: trueSetzen Sie auf false, wenn Sie ein stummes Video benötigen.
integer
Seed-Ganzzahl zur Steuerung der Zufälligkeit bei der GenerierungWertebereich: Ganzzahl zwischen -1 und 2^32-1
  • Bei gleicher Anfrage führen unterschiedliche Seed-Werte (einschließlich nicht angegeben oder -1, was eine Zufallszahl verwendet) zu unterschiedlichen Ergebnissen
  • Bei gleicher Anfrage erzeugt derselbe Seed-Wert ähnliche Ergebnisse, eine exakte Reproduzierbarkeit ist jedoch nicht garantiert

Automatisches Routing

Das System bestimmt den Generierungsmodus automatisch anhand der Anzahl der Bilder in image_urls:

Parameter-Support-Matrix

Antwort

integer
Statuscode der Antwort, 200 bei Erfolg
array
Datenarray der Antwort

Anwendungsfälle

Fall 1: Text-zu-Video

Fall 2: Bild-zu-Video (einzelnes Bild)

Fall 3: Video aus erstem und letztem Bild

Fall 4: Stummes Video (Audio deaktiviert)

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