Skip to main content
POST

Autorisation

string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à l’en-tête de la requête :

Modes de génération

SkyReels V4 sélectionne automatiquement le bon mode en fonction des champs de la requête — aucun champ mode n’est nécessaire :
Exclusion mutuelle stricte : les champs I2V (first_frame_image / end_frame_image / mid_frame_images) et les champs Omni (ref_images / ref_videos) ne peuvent pas être utilisés ensemble, sinon le code 422 est renvoyé.
Mécanisme @tag : lors de l’utilisation de mid_frame_images / ref_images / ref_videos, chaque élément doit déclarer un tag commençant par @ (par exemple, @image1, @Actor-1, @video1), et ce tag doit apparaître dans le prompt.Considérez le prompt comme un « script » et le tag comme un « pointeur de personnage » vers des ressources spécifiques (images / vidéos). Par exemple, un prompt tel que "@Actor-1 walks into the scene of @video1" indique au système d’injecter dans le processus de génération le sujet de l’image de référence associé à @Actor-1 et la référence de mouvement associée à @video1.

Paramètres de la requête

Champs généraux

string
requis
Deux niveaux de modèle sont disponibles :
Le champ model doit être fourni explicitement — aucune valeur par défaut.
Le prix est fortement lié à la résolution et à l’utilisation de ref_videos : 1080p est nettement plus cher que 480p / 720p ; les niveaux avec ref_videos (entrée vidéo) coûtent environ 1,5 à 2 fois plus que ceux sans. La sortie audio et vidéo simultanée n’est pas encore prise en charge.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Prompt textuel, 1280 tokens maximumDécrivez les scènes, sujets, actions et styles en détail pour de meilleurs résultats.Lors de l’utilisation de ref_images / ref_videos / mid_frame_images, le prompt doit contenir le @tag correspondant (par exemple, @Actor-1, @video1, @image1).Exemple : "@Actor-1 walks through a neon-lit street at night."
integer
défaut:"5"
Durée de la vidéo de sortie (secondes)
  • Plage : [3, 15]
  • Par défaut : 5
Lorsque ref_videos.type=reference est fourni, duration est remplacé par la durée de la vidéo de référence (maximum 10 secondes).
string
défaut:"1080p"
Résolution de la vidéoOptions :
  • 480p
  • 720p
  • 1080p (par défaut)
string
défaut:"16:9"
Rapport d’aspectOptions :
  • 16:9 (par défaut)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
aspect_ratio est ignoré en mode I2V (le rapport de sortie est déterminé par l’image d’entrée) ; également ignoré lorsque Omni est combiné avec ref_videos.
boolean
défaut:"true"
Optimiser automatiquement le promptLorsqu’activé, le système optimise automatiquement votre prompt pour de meilleurs résultats.

Champs spécifiques à I2V

string
URL de l’image de première trame (jpg / jpeg / png / gif / bmp)Lorsqu’elle est fournie, cette image est utilisée comme trame initiale de la vidéo.
string
URL de l’image de dernière trame (jpg / jpeg / png / gif / bmp)Lorsqu’elle est fournie, cette image est utilisée comme trame finale de la vidéo. Peut être combinée avec first_frame_image pour contrôler les trames de début et de fin.
object[]
Liste des trames clés intermédiaires, jusqu’à 6. Chaque élément a la structure suivante :

Champs spécifiques à Omni

object[]
Liste des images de référence (tous les éléments doivent partager le même type). Chaque élément a la structure suivante :
object[]
Liste des vidéos de référence, jusqu’à 1. Chaque élément a la structure suivante :

Scénarios pris en charge

Les scénarios suivants sont pris en charge à la fois par skyreels-v4-fast et skyreels-v4-std :

Contraintes des paramètres

La violation de l’une des contraintes suivantes entraîne le rejet de la requête avec une réponse 422, aucune facturation n’a lieu :

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Exemples de requêtes

Cas 1 : Texte vers vidéo (minimal)

Cas 2 : Texte vers vidéo (paramètres complets)

Cas 3 : Image vers vidéo — Première trame

Cas 4 : Image vers vidéo — Première/Dernière trame + trames clés intermédiaires

Cas 5 : Omni — Référence à un sujet unique

Cas 6 : Omni — Multi-sujets + référence de mouvement vidéo

Ce cas utilise ref_videos.type=reference, donc le duration demandé sera remplacé par la durée réelle de la vidéo de référence (maximum 10 secondes). Même si "duration": 5 est transmis ici, la durée finale de la vidéo suit la vidéo de référence.

Cas 7 : Omni — Collage en grille

Cas 8 : Omni — Extension de vidéo (extend)

Cas 9 : Omni — Synchronisation audio (piloté par voix)

Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.