Seedance 2.0 API
Référence API complète des modèles de génération vidéo Seedance 2.0 de ByteDance.
Variantes de modèles
Cette API prend en charge six variantes :
Comparaison rapide
Formats d'image pris en charge
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Résolutions disponibles
Seedance 2.0 Texte vers vidéo
Point de terminaison
POST /api/v1/video/task
Paramètres de requête
Obligatoires
Facultatifs
Exemple de requête
javascript
Seedance 2.0 Image vers vidéo
Paramètres de requête
Obligatoires
Facultatifs
Exemple de requête
javascript
Seedance 2.0 Références vers vidéo
Paramètres de requête
Obligatoires
Médias de référence
Envoyez 1-9 images. Les images ne peuvent être omises que si au moins une vidéo de référence est fournie.
Marqueurs de référence @ (AT)
La fonction @ (AT) relie les médias de référence au prompt via des marqueurs numérotés <<<...>>>. La numérotation commence à 1 indépendamment pour chaque type de média et suit l'ordre du tableau correspondant :
Par exemple, si la première image représente un personnage et la deuxième une scène, utilisez <<<image_1>>> pour le personnage et <<<image_2>>> pour la scène dans prompt. Chaque marqueur doit désigner un élément existant dans son tableau.
Facultatifs
Exemple de requête
javascript
Exemple de requête Références vers vidéo avec @ (AT)
javascript
Variantes Fast
Les variantes Fast privilégient la vitesse de traitement. Tous les modèles Fast prennent uniquement en charge les sorties "480p" et "720p". Fast Texte vers vidéo et Fast Image vers vidéo suivent par ailleurs la structure des requêtes standard correspondantes, tandis que Fast Références vers vidéo applique les mêmes limites de médias de référence que le modèle standard.
Exemple de requête Fast
javascript
Exemple de requête Fast Références vers vidéo avec @ (AT)
javascript
Paramètres Seedance 2.0 Fast Références vers vidéo
Obligatoires
Médias de référence
La même convention de marqueurs commençant à 1 s'applique au modèle Fast Références vers vidéo.
Facultatifs
Limites des médias
Ces limites s'appliquent aux images de début, de fin et aux médias de référence des modèles de cette page.
Les audios et vidéos de référence ont chacun une limite distincte de durée totale de 15 secondes. Leurs nombres sont indépendants : jusqu'à 9 images, 3 vidéos et 3 extraits audio. Ajouter des vidéos ne réduit pas le nombre d'images autorisé.
Tous les modèles utilisent 720p par défaut, mais resolution reste obligatoire. Le son est activé par défaut (true) ; ni ce réglage ni l'audio de référence ne modifient le prix. Références vers vidéo nécessite au moins une image ou une vidéo ; les requêtes uniquement audio ne sont pas prises en charge. L'ajout de vidéos de référence double le coût de génération, quels que soient leur nombre et leur durée.
Format de réponse
Réponse initiale
Tous les modèles renvoient un task_id pour l'interrogation périodique :
json
Réponse d'interrogation
Interrogez GET /api/v1/video/{taskId} pour vérifier l'état :
json
Valeurs d'état
submitted: tâche acceptée, 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
Modèles standard : 3-8 minutes selon la durée et la résolution.
Modèles Fast : 1-4 minutes pour la plupart des configurations.
Vérifiez l'état toutes les 5-10 secondes.
Bonnes pratiques
- Choisir la bonne variante : utilisez les modèles Fast pour les essais et les modèles standard pour le résultat final
- Décrire clairement le mouvement : incluez des descriptions précises des mouvements dans les prompts
- Choix de la résolution : tous les modèles Seedance 2.0 standard prennent en charge
480p,720p,1080pet4k; tous les modèles Fast prennent uniquement en charge480pet720p - Ordre des références : ordonnez délibérément
images,videosetaudios, puis référencez-les de manière cohérente dans le prompt - Requêtes uniquement vidéo : utilisez un tableau
imagesvide uniquement si au moins une vidéo de référence est fournie - Durée des médias : maintenez chaque audio et vidéo de référence entre 2 et 15 secondes
- Utilisation du son : omettez
soundpour utiliser sa valeur par défauttrue, ou définissez-le surfalsepour désactiver le son généré