Seedance 2.5 Flash API
Documentation complète de l’API des modèles de génération vidéo Seedance 2.5 Flash de ByteDance.
Variantes du modèle
Cette API prend en charge trois variantes du modèle :
Comparaison rapide
Rapports largeur/hauteur pris en charge
Les variantes de génération à partir de texte et de références acceptent les rapports suivants :
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
La variante de génération à partir d’une image ne prend pas en charge le paramètre aspect_ratio.
Résolutions disponibles
Seedance 2.5 Flash Text to Video
Point de terminaison
POST /api/v1/video/task
Paramètres de la requête
Paramètres obligatoires
Paramètres facultatifs
Exemple de requête
javascript
Seedance 2.5 Flash Image to Video
Paramètres de la requête
Paramètres obligatoires
Paramètres facultatifs
N’incluez pas
aspect_ratiodans les requêtes de génération vidéo à partir d’une image. Ce modèle ne prend pas en charge ce paramètre.
Exemple de requête
javascript
Seedance 2.5 Flash Reference to Video
Paramètres de la requête
Paramètres obligatoires
Médias de référence
Tous les médias de référence sont facultatifs. Les requêtes peuvent contenir uniquement des images, des vidéos ou des extraits audio, ou aucun média de référence. Pour générer une vidéo sans référence, la variante Text to Video est recommandée.
Marqueurs de référence @ (AT)
La fonction de référence @ (AT) associe les médias de référence à l’instruction au moyen de marqueurs numérotés <<<...>>>. Pour chaque type de média, la numérotation commence à 1 et suit l’ordre du tableau correspondant :
Par exemple, si la première image représente un personnage et la seconde un décor, utilisez <<<image_1>>> pour le personnage et <<<image_2>>> pour le décor dans prompt. Chaque marqueur doit désigner un élément présent dans le tableau correspondant.
Paramètres facultatifs
Exemple de requête
javascript
Exemple de requête de génération vidéo avec des références @ (AT)
javascript
Limites des médias
Ces limites s’appliquent aux premières et dernières images ainsi qu’aux médias de référence des modèles présentés sur cette page.
La durée cumulée des extraits audio de référence et celle des vidéos de référence sont limitées séparément à 30 secondes chacune. Les quantités maximales sont indépendantes : 10 images, 5 vidéos et 5 extraits audio.
Tous les modèles exigent resolution et duration, sans valeur par défaut. Les variantes de génération à partir de texte et de références utilisent 16:9 par défaut si aspect_ratio est omis. Le son est activé par défaut (true). Utilisez false pour obtenir une vidéo muette.
Format de la réponse
Réponse initiale
Tous les modèles renvoient un task_id qui permet d’interroger l’état de la tâche :
json
Réponse aux requêtes de suivi
Interrogez GET /api/v1/video/{taskId} pour vérifier l’état de la tâche :
json
Valeurs d’état
submitted: Tâche acceptée et en attente de traitementprocessing: Génération vidéo en courssucceed: Génération vidéo terminéefailed: Échec de la génération vidéo
Temps de traitement
Le temps de traitement varie selon la durée, la résolution et l’état de la file d’attente.
Vérifiez l’état de la tâche toutes les 5 à 10 secondes.
Bonnes pratiques
- Paramètres obligatoires : fournissez toujours
prompt,resolutionetduration. Pour les variantes de génération à partir de texte et de références,aspect_ratioest facultatif et vaut16:9par défaut - Rapport largeur/hauteur pour la génération à partir d’une image : n’envoyez pas
aspect_ratiodans ces requêtes - Vidéos de référence : les vidéos sont facultatives. Leur durée individuelle et leur durée cumulée doivent respecter les limites indiquées
- Images de référence : les images sont facultatives, indépendamment des vidéos et des extraits audio. Vous pouvez fournir jusqu’à 10 URL d’images dans les formats pris en charge
- Audio de référence : chaque extrait doit durer de 2 à 30 secondes et peser au maximum 15 Mo, pour une durée cumulée de 30 secondes maximum
- Ordre des références : placez les éléments de
images,videosetaudiosdans l’ordre souhaité et respectez cet ordre lorsque vous les mentionnez dans l’instruction - Son : omettez
soundpour utiliser sa valeur par défauttrue, ou réglez-le surfalsepour désactiver la génération du son