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-mix — Premium-Qualität, stärkere intelligente Übergänge, unterstützt 1-Sekunden-Kurzvideos
  • viduq3 — Standardauswahl, intelligenterer Kamerawechsel
So wählen Sie: Verwenden Sie viduq3 für den täglichen Einsatz; nutzen Sie viduq3-mix für Premium-Qualität oder Bewegungseffekte von 1–2 Sekunden.
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 5000 ZeichenBeschreiben Sie Aktionen und Kameraführungen, nicht das Aussehen (das Aussehen wird durch die Referenzbilder bestimmt).Beispiel: "Santa Claus and the bear hug by the lakeside"
array<url>
erforderlich
Array mit URLs der Referenzbilder, 1–7 BilderUnterstützt öffentlich zugängliche Bild-URLs (http:// oder https://)Beispiel: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Anzahl: 1–7 Bilder
  • Unterstützte Formate: PNG, JPEG, JPG, WebP
  • Mindestgröße: 128×128
  • Seitenverhältnis: zwischen 1:4 und 4:1
  • Maximale Dateigröße: ≤ 50 MB pro Bild
  • Müssen öffentlich zugängliche URLs sein
integer
Standard:"5"
Videodauer (Sekunden)
  • viduq3-mix: 1 bis 16
  • viduq3: 3 bis 16
Standard: 5
viduq3 unterstützt mindestens 3 Sekunden, viduq3-mix unterstützt mindestens 1 Sekunde. Bitte übergeben Sie eine gültige Dauer entsprechend dem gewählten Modell.
string
Standard:"720p"
Auflösung des Videos
  • viduq3-mix: 720p (Standard) / 1080p
  • viduq3: 540p / 720p (Standard) / 1080p
viduq3-mix unterstützt 540p nicht, bitte verwenden Sie 720p oder 1080p.
string
Standard:"16:9"
Seitenverhältnis des VideosOptionen:
  • 16:9 — Querformat (Standard)
  • 9:16 — Hochformat
  • 4:3 — Traditionell
  • 3:4 — Traditionelles Hochformat
  • 1:1 — Quadrat
integer
Zufalls-Seed zur Steuerung der GenerierungsvariabilitätWenn nicht angegeben, wird ein zufälliger Seed verwendet.
Bei Verwendung desselben Seeds mit identischen Parametern werden ähnliche Ergebnisse erzeugt, jedoch nicht garantiert exakt dieselben.

Modellvergleich

Antwort

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

Anwendungsfälle

Fall 1: viduq3 Basis Reference-to-Video

Fall 2: viduq3-mix Reference-to-Video in hoher Qualität

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.