Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenFügen Sie ihn zum Request-Header hinzu:

Generierungsmodi

SkyReels V4 wählt den passenden Modus automatisch anhand der Anfragefelder — kein mode-Feld erforderlich:
Strikte gegenseitige Ausschließlichkeit: I2V-Felder (first_frame_image / end_frame_image / mid_frame_images) und Omni-Felder (ref_images / ref_videos) können nicht zusammen verwendet werden, andernfalls wird 422 zurückgegeben.
@tag-Mechanismus: Bei Verwendung von mid_frame_images / ref_images / ref_videos muss jedes Element ein tag deklarieren, das mit @ beginnt (z. B. @image1, @Actor-1, @video1), und dieser tag muss im prompt vorkommen.Stellen Sie sich prompt als „Drehbuch” und tag als „Zeiger auf eine Figur” für bestimmte Assets (Bilder / Videos) vor. Ein Prompt wie "@Actor-1 walks into the scene of @video1" weist das System beispielsweise an, das mit @Actor-1 verknüpfte Referenzbildsubjekt und die mit @video1 verknüpfte Bewegungsreferenz in den Generierungsprozess einzufügen.

Anfrageparameter

Allgemeine Felder

string
erforderlich
Zwei Modellstufen stehen zur Verfügung:
Das Feld model muss explizit angegeben werden — kein Standardwert.
Der Preis hängt stark von der Auflösung und der Verwendung von ref_videos ab: 1080p ist deutlich teurer als 480p / 720p; Varianten mit ref_videos (Videoeingabe) kosten ca. das 1,5- bis 2-fache im Vergleich zu denen ohne. Die gleichzeitige Audio- und Videoausgabe wird noch nicht unterstützt.
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
Text-Prompt, maximal 1280 TokensBeschreiben Sie Szenen, Subjekte, Aktionen und Stile detailliert für bessere Generierungsergebnisse.Bei Verwendung von ref_images / ref_videos / mid_frame_images muss der entsprechende @tag (z. B. @Actor-1, @video1, @image1) im prompt enthalten sein.Beispiel: "@Actor-1 walks through a neon-lit street at night."
integer
Standard:"5"
Dauer des Ausgabevideos (Sekunden)
  • Bereich: [3, 15]
  • Standard: 5
Wenn ref_videos.type=reference angegeben wird, wird duration durch die Länge des Referenzvideos überschrieben (maximal 10 Sekunden).
string
Standard:"1080p"
VideoauflösungOptionen:
  • 480p
  • 720p
  • 1080p (Standard)
string
Standard:"16:9"
SeitenverhältnisOptionen:
  • 16:9 (Standard)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
aspect_ratio wird im I2V-Modus ignoriert (das Ausgabeverhältnis wird durch das Eingabebild bestimmt); ebenfalls ignoriert, wenn Omni mit ref_videos kombiniert wird.
boolean
Standard:"true"
Soll der Prompt automatisch optimiert werden?Bei Aktivierung optimiert das System Ihren Prompt automatisch für bessere Generierungsergebnisse.

I2V-spezifische Felder

string
URL des ersten Einzelbildes (jpg / jpeg / png / gif / bmp)Wenn angegeben, wird dieses Bild als Anfangsbild des Videos verwendet.
string
URL des letzten Einzelbildes (jpg / jpeg / png / gif / bmp)Wenn angegeben, wird dieses Bild als Endbild des Videos verwendet. Kann mit first_frame_image für die Steuerung von Erst- und Endbild kombiniert werden.
object[]
Liste mittlerer Schlüsselbilder, bis zu 6. Jedes Element hat die folgende Struktur:

Omni-spezifische Felder

object[]
Liste der Referenzbilder (alle Elemente müssen denselben type haben). Jedes Element hat die folgende Struktur:
object[]
Liste der Referenzvideos, bis zu 1. Jedes Element hat die folgende Struktur:

Unterstützte Szenarien

Die folgenden Szenarien werden sowohl von skyreels-v4-fast als auch skyreels-v4-std unterstützt:

Parameter-Einschränkungen

Bei Verletzung einer der folgenden Bedingungen wird die Anfrage mit einer 422-Antwort abgelehnt, es erfolgt keine Abrechnung:

Antwort

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

Anfragebeispiele

Fall 1: Text-zu-Video (minimal)

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

Fall 3: Bild-zu-Video — Erstes Einzelbild

Fall 4: Bild-zu-Video — Erstes/Letztes Einzelbild + mittlere Schlüsselbilder

Fall 5: Omni — Einzelne Subjektreferenz

Fall 6: Omni — Mehrere Subjekte + Video-Bewegungsreferenz

In diesem Fall wird ref_videos.type=reference verwendet, daher wird der angeforderte duration durch die tatsächliche Länge des Referenzvideos überschrieben (maximal 10 Sekunden). Auch wenn hier "duration": 5 übergeben wird, richtet sich die endgültige Videolänge nach dem Referenzvideo.

Fall 7: Omni — Raster-Collage

Fall 8: Omni — Videoverlängerung (extend)

Fall 9: Omni — Audiosynchronisation (sprachgesteuert)

Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die nach der Übermittlung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Generierungsfortschritt und die Ergebnisse abzufragen.