Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Anfragen erfordern eine Authentifizierung per Bearer Token.API-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhalten.Fügen Sie beim Senden von Anfragen den folgenden Header hinzu:

Anfrageparameter

string
erforderlich
Name des Videogenerierungsmodells. Muss Omni-Flash-Ext sein.
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
Beschreibung des Videoinhalts. Wir empfehlen, Szene, Subjekt, Aktion, Umgebung, Kameraführung, visuellen Stil und Audiohinweise detailliert zu beschreiben.Beispiel: "a girl is dancing happily in a sunny garden"
integer
Standard:"6"
Videodauer in Sekunden.Unterstützte Werte: 4, 6, 8, 10.
Andere Werte wie 5 oder 7 geben einen invalid_duration-Fehler zurück.
Übergeben Sie duration nicht, wenn Sie ein Referenzvideo hochladen. duration und video_urls können nicht gleichzeitig übergeben werden.
string
Standard:"720p"
Auflösung des Videos. Werte sind unabhängig von der Groß-/Kleinschreibung.Unterstützte Werte:
  • 720p
  • 1080p
  • 4k
Andere Auflösungen geben einen invalid_resolution-Fehler zurück.
string
Standard:"16:9"
Seitenverhältnis des Videos. Damit steuern Sie die Ausgabe in Quer- oder Hochformat.Übliche Werte:
  • 16:9 — Querformat
  • 9:16 — Hochformat
Standard: 16:9
string
Kompatibilitätsfeld. Hat die gleiche Bedeutung wie aspect_ratio. Wenn beide angegeben sind, halten Sie sie konsistent.
string
Generierungstyp, der angibt, wie die Bilder verwendet werden.Optionen:
  • frame - Erstes-Bild-Modus. image_urls darf nur 1 Bild enthalten, das als erstes Bild des Videos verwendet wird.
  • reference - Referenzmodus. image_urls kann 1 oder 3 Bilder enthalten, die als Referenzbilder verwendet werden.
Wenn generation_type frame ist, unterstützt image_urls nur 1 Bild; die Übergabe einer anderen Anzahl gibt einen unsupported_image_count-Fehler zurück.
array<url>
Array mit URLs der Referenzbilder. Sie können es weglassen, 1 Bild oder 3 Bilder bereitstellen, abhängig von generation_type:
  • Weggelassen oder leeres Array: Text-to-Video
  • 1 Bild: Image-to-Video mit einem Bild
  • 3 Bilder: Fusion von Referenzbildern (nur unterstützt, wenn generation_type reference ist)
Beziehung zu generation_type:
  • generation_type ist frame: Es darf nur 1 Bild hochgeladen werden.
  • generation_type ist reference: Es können 1 oder 3 Bilder hochgeladen werden.
Es werden nur öffentlich zugängliche Bild-URLs unterstützt.
Der Modus „Erstes Bild + letztes Bild” mit 2 Bildern wird nicht unterstützt. Die Übergabe von 2 Bildern gibt einen unsupported_image_count-Fehler zurück. 4 oder mehr Bilder sind nicht vollständig verifiziert und werden nicht empfohlen.
array<url>
Array mit URLs der Referenzvideos. Sie können es weglassen oder 1 Referenzvideo bereitstellen.Es werden nur öffentlich zugängliche HTTP/HTTPS-Video-URLs unterstützt. Es kann zusammen mit image_urls übergeben werden: Bilder dienen als Identitäts- oder Kompositionsreferenz, das Video als Bewegungsreferenz.
Omni-Flash-Ext unterstützt nur 0 oder 1 Referenzvideo. Die Übergabe von 2 oder mehr Videos gibt einen unsupported_video_count-Fehler zurück.
Übergeben Sie duration nicht, wenn Sie video_urls übergeben. video_urls und duration können nicht gleichzeitig übergeben werden.

Antwort

integer
Statuscode der Antwort. Erfolgreiche Anfragen geben 200 zurück.
array
Zurückgegebenes Task-Array.

Aufgabenergebnis abfragen

Die Videogenerierung erfolgt asynchron. Nach der Einreichung gibt die API eine task_id zurück. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnisse abzufragen.
cURL
Wir empfehlen, nach der Einreichung 5–10 Sekunden bis zur ersten Abfrage zu warten und dann alle 5–10 Sekunden zu pollen. Eine einzelne Aufgabe wird in der Regel in etwa 3–5 Minuten abgeschlossen.

Beispiel für ein erfolgreiches Ergebnis

Beispiel für ein fehlgeschlagenes Ergebnis

Anwendungsfälle

Szenario 1: Text-zu-Video

Szenario 2: Video mit einem Bild

Szenario 3: Fusion von 3 Referenzbildern

Szenario 4: Kurzes 4K-Video

Szenario 5: Generierung mit Referenzvideo

Fehlercodes

Wenn eine Aufgabe fehlschlägt, gibt die Status-API der Aufgabe den Fehlergrund in data.error zurück. Häufige Ursachen sind vorübergehende Kontingenterschöpfungen beim Upstream, fehlgeschlagene Inhaltsmoderation oder Timeout beim Upstream.