Introduction
Seedance 2.0 Mini références vers vidéo réunit plusieurs sources autorisées dans un seul plan : des images pour le qui et le quoi, des clips pour le mouvement et le rythme, de l’audio pour le temps fort sur lequel tombe la coupe. Il ne prend pas de première image.
Seedance 2.0 Mini est le plus petit niveau de la gamme Seedance 2.0 de ByteDance. Il publie les trois mêmes points de terminaison que Seedance 2.0 Fast et renvoie des clips de 4 à 15 secondes en 480p ou 720p, avec un son généré dans la même passe.
Choisir le mode Seedance 2.0 Mini selon votre matériau de départ
| Matériau de départ | Mode |
|---|---|
| Un script ou la description d’une scène | Seedance 2.0 Mini Texte vers vidéo |
| Une image de départ validée | Seedance 2.0 Mini Image vers vidéo |
| Des références séparées pour l’apparence, le mouvement ou le son | Seedance 2.0 Mini Références vers vidéo |
Fonctionnalités et points forts
Le même contrat que Seedance 2.0 Fast
Mini publie les mêmes points de terminaison et les mêmes champs que Seedance 2.0 Fast : format adaptatif plus six formats fixes, 4 à 15 secondes ou -1 pour une durée choisie par le modèle, son natif et seed, avec une résolution plafonnée à 720p. Un pipeline écrit pour Mini passe à Fast en changeant l’identifiant du modèle, pas la requête.
Conçu pour le volume
Mini est le niveau à choisir quand le débit compte plus que la qualité supplémentaire des modèles Seedance 2.0 plus grands. Chaque point de terminaison est asynchrone : envoyez un Idempotency-Key avec chaque requête, conservez les identifiants de tâche et laissez le polling ou les callbacks les résoudre. La clé est honorée pendant 24 heures, donc une nouvelle tentative après une coupure renvoie la tâche d’origine.
Des séquences plus longues avec la prolongation vidéo
Pour dépasser quinze secondes, envoyez un clip terminé au point de terminaison video-extend : sa dernière image ouvre un nouveau plan Seedance 2.0 Mini et vous récupérez un seul fichier où les deux parties sont assemblées. Chaque étape ne facture que les secondes qu’elle ajoute, et le résultat assemblé peut être prolongé de nouveau.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, et ici il fait aussi le casting. 1 caractères minimum |
reference_image_urls | Non | Jusqu’à 9 images que vous êtes autorisé à utiliser, pour un personnage, un produit, un style ou un décor. 9 éléments maximum |
reference_video_urls | Non | Jusqu’à 3 clips qui apportent le mouvement, le rythme ou le langage de caméra. 3 éléments maximum |
reference_audio_urls | Non | Jusqu’à 3 fichiers audio, de 2 à 15 secondes chacun et 15 secondes au total, chacun sous 15 Mo, qui donnent au plan un ancrage sonore — diction, tempo, phrase musicale — sur leq… 3 éléments maximum |
aspect_ratio | Non | Cadrage de sortie, adaptive par défaut : le clip prend la forme de la référence principale. |
resolution | Non | Résolution de sortie : 480p ou 720p par défaut. Elle sélectionne un palier tarifaire et ne rendra pas nettes des références basse résolution. |
duration_seconds | Non | Durée du clip final en secondes entières, de 4 à 15, 5 par défaut ; -1 laisse le modèle choisir, l’estimation comptant alors 15 secondes. |
generate_audio | Non | Détermine si une bande-son native est rendue en synchronisation avec l’image. Actif par défaut ; le couper ne fait pas baisser le tarif dans cette variante. Valeur par défaut: |
enable_web_search | Non | Désactivé par défaut. Activé, le modèle peut chercher sur le web des informations liées à votre prompt avant le rendu. Valeur par défaut: |
seed | Non | Seed entière ; omettez-la et chaque tirage tire la sienne. Fixez-la, tout le reste étant constant, pour juger ce qu’une retouche de prompt a réellement changé. |
return_last_frame | Non | Renvoie en plus la dernière image du clip, sous forme d’image distincte à côté de la vidéo. Valeur par défaut: |
bitrate_mode | Non | Débit d’encodage du fichier livré : |
watermark | Non | Ajoute à la vidéo le filigrane visible « AI generated » propre au modèle. Valeur par défaut: |
Tarification
Les clips de référence s’ajoutent aux secondes facturées. Comme nous ne pouvons pas mesurer vos clips avant l’exécution, nous bloquons d’abord le montant correspondant au maximum de 15 secondes, puis libérons la part inutilisée dès la facturation — vous ne payez que les secondes réellement utilisées.
| Spécification | Prix |
|---|---|
| $0.010969 / seconde |
| $0.023588 / seconde |
| $0.0246078 / seconde |
| $0.05292 / seconde |
| $0.036 / seconde |
| $0.072 / seconde |
Cas d’utilisation
Un seul jeu de références pour toute une série
Trois vues d’un homme — de face, de trois quarts et de profil — plus une quatrième image de son tablier peuvent porter toute une série, seul le prompt changeant d’une requête à l’autre. L’exemple publié de la boulangerie est construit exactement ainsi.
Un rythme emprunté à un clip
Un clip de référence peut apporter un rythme plutôt qu’un contenu. Un exemple reprend la poussée lente et continue d’un clip, la met en scène dans l’allée d’une image de référence et cale les pas sur la pulsation d’une piste de référence, huit secondes en 9:16.
Un couple stable sous plusieurs angles
Trois images du même couple permettent à un nouveau plan de trouver un troisième angle tandis que visages et tenues restent identiques, comme dans l’exemple du banc public rendu en 480p.
Guide de prompt et conseils pratiques
Désignez chaque référence par sa position
Le prompt est obligatoire et fait le casting, car les références sont lues dans l’ordre d’envoi. Écrivez « References 1-3 are… » ou utilisez @Image1, @Image2 pour que chaque élément ait une seule tâche.
Connaissez les plafonds
Envoyez jusqu’à 9 images, 3 clips et 3 pistes audio, avec au moins une image ou un clip dans chaque requête. Clips et audio durent de 2 à 15 secondes chacun et 15 secondes au total, et les secondes de vos clips de référence sont facturées en plus de la sortie.
Adaptez l’exemple fourni
L’exemple publié utilise aspect_ratio 16:9, duration_seconds 6, generate_audio true et resolution 720p, avec quatre images dans reference_image_urls.
@Image1, @Image2 and @Image3 are the same man from front, three-quarter and profile; @Image4 is his apron. Put him behind the counter of a small bakery at opening time in that apron, sliding a tray into the case and glancing up as the door chimes. Warm ovens, flat morning light.
Trois angles tiennent le visage, la quatrième image tient le costume, et le prompt dit qui est qui. Gardez ce partage quand vous distribuez votre propre personnage.
Besoin d’une première image exacte ? Passez par l’image vers vidéo
Ce point de terminaison n’a pas de champ de première ni de dernière image. Quand l’image d’ouverture doit correspondre exactement à une photo, envoyez cette photo à l’image vers vidéo et décrivez seulement le mouvement.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0-mini/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"enable_web_search": false,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
