Omni-Flash-Ext
Omni-Flash-Ext Videogenerierung
- Einheitliches Videogenerierungsmodell Omni-Flash-Ext
- Unterstützt Text-to-Video, Image-to-Video mit einem Bild, Referenzvideo und Fusion von 3 Referenzbildern
- Unterstützt 720p / 1080p / 4k Auflösung sowie Dauern von 4 / 6 / 8 / 10 Sekunden
- Asynchrone Task-API. Zuerst wird eine Aufgabe eingereicht, anschließend wird das Ergebnis über die Task-ID abgefragt
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 mitomni-moderation-latestprüfenfalseoder 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.string
Standard:"720p"
Auflösung des Videos. Werte sind unabhängig von der Groß-/Kleinschreibung.Unterstützte Werte:
720p1080p4k
string
Standard:"16:9"
Seitenverhältnis des Videos. Damit steuern Sie die Ausgabe in Quer- oder Hochformat.Übliche Werte:
16:9— Querformat9:16— Hochformat
16:9string
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_urlsdarf nur 1 Bild enthalten, das als erstes Bild des Videos verwendet wird.reference- Referenzmodus.image_urlskann 1 oder 3 Bilder enthalten, die als Referenzbilder verwendet werden.
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_typereferenceist)
generation_type:generation_typeistframe: Es darf nur 1 Bild hochgeladen werden.generation_typeistreference: Es können 1 oder 3 Bilder hochgeladen werden.
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.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 einetask_id zurück. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnisse abzufragen.
cURL
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.