Introduction
Seedance 2.5 Références vers vidéo construit une nouvelle séquence à partir de matériaux qui guident son apparence, son mouvement ou sa bande-son. Choisissez ce mode quand une image de personnage, un lieu, une référence de caméra ou une piste audio doivent chacun apporter une partie différente du brief.
ByteDance a présenté Seedance 2.5 dans son article de lancement du 31 juillet 2026, avec la création souple à partir de références comme capacité centrale. Ce point de terminaison sert à réunir ces indications dans une nouvelle vidéo, et non à fixer une photo fournie comme première image.
Choisir le point de départ de votre séquence Seedance 2.5
| Matériau de départ | Mode |
|---|---|
| Un script ou la description d’une scène | Seedance 2.5 Texte vers vidéo |
| Une image de départ validée | Seedance 2.5 Image vers vidéo |
| Des références séparées pour l’apparence, le mouvement ou le son | Seedance 2.5 Références vers vidéo |
Fonctionnalités et points forts
Des histoires plus longues en une seule génération
Seedance 2.5 accepte des clips jusqu’à 30 secondes, ce qui laisse à une séquence la place d’une mise en place, d’un développement et d’une fin. Ses capacités narratives incluent des plans enchaînés et des transitions de scène, et pas seulement le prolongement d’un geste.
Des références multimodales souples
Images, séquences vidéo et audio peuvent guider différents éléments d’une même production. Le flux de références élargi prend en charge des distributions, des décors et des découpages plus complexes, en séparant l’apparence du mouvement et du son.
Un guidage par rendus en pâte à modeler et storyboards
Des images de préparation 3D sommaires peuvent transmettre la structure spatiale, la mise en place et le mouvement de caméra, tandis que les références visuelles apportent le rendu final. Les storyboards et les images clés ordonnées offrent d’autres moyens de décrire une séquence.
Une direction visuelle et sonore plus fine
Le développement du modèle met l’accent sur les matières, la lumière, le détail de la peau et des yeux, ainsi que sur la coordination du son et du mouvement. Les prompts peuvent préciser séparément dialogues, effets et ambiance, et organiser les événements avec des repères temporels en secondes entières.
Montage ciblé et prolongement
La famille du modèle comprend des modifications vidéo ciblées dans le temps, des changements d’arrière-plan et le prolongement d’images existantes. Ce sont des flux distincts avec entrée vidéo ; leur disponibilité et leurs réglages dépendent de la tâche choisie, et non d’une requête texte vers vidéo ou image vers vidéo.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, et ici il fait aussi le casting. |
reference_image_urls | Non | Jusqu’à 30 images de référence, servant à tenir un personnage, un style ou un décor — la génération précédente n’en autorisait que 9, il y a donc de la vraie marge. 30 éléments maximum |
reference_video_urls | Non | Jusqu’à 10 clips de référence qui fournissent le mouvement, le rythme ou le langage de caméra. 10 éléments maximum |
reference_audio_urls | Non | Jusqu’à 10 fichiers audio de référence, de 2 à 30 secondes chacun et d’une durée cumulée d’au plus 30 secondes (la génération précédente n’autorisait que 3 fichiers pour 15 seco… 10 éléments maximum |
aspect_ratio | Non | Vaut |
resolution | Non | 480p, 720p ou 1080p, 720p par défaut, et elle alimente directement la quantité facturée. |
duration_seconds | Non | De 4 à 30 secondes, 5 par défaut. |
generate_audio | Non | Actif par défaut. Il produit une bande-son native synchronisée avec l’image. Valeur par défaut: |
output_format | Non | Le conteneur de la vidéo livrée : mp4 (par défaut) ou mov. |
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: |
watermark | Non | Demande au modèle d’apposer sur la vidéo un filigrane signalant un contenu généré par IA, comme le décrit sa propre documentation. 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 30 secondes, puis libérons la part inutilisée dès la facturation — vous ne payez que les secondes réellement utilisées.
| Résolution | With video: Oui | With video: Non |
|---|---|---|
| $0.0738 / seconde | $0.1234 / seconde |
| $0.1659 / seconde | $0.2773 / seconde |
| $0.4082 / seconde | $0.6823 / seconde |
Cas d’utilisation
Combiner un personnage, un décor et un plan de caméra
Fournissez des images autorisées de la personne, une référence d’environnement et un court clip montrant le mouvement voulu. Évaluez séparément les trois apports : identité, placement et comportement de la caméra.
Faire d’une répétition de caméra sommaire une scène stylisée
Utilisez des images de préparation simples pour le mouvement et une référence de rendu pour les matières et la lumière. Expliquez quelles parties des images de préparation ignorer. Vérifiez les rapports spatiaux au lieu de supposer que la géométrie générée est exacte.
Esquisser des images pour une piste audio autorisée
Envoyez une référence sonore et décrivez les images, l’ambiance et les actions qui doivent l’accompagner. Vérifiez le rapport entre les repères musicaux ou parlés et l’image ; le résultat n’est pas garanti calé au temps près.
Guide de prompt et conseils pratiques
Associer plusieurs références dans Seedance 2.5
Écrivez une correspondance explicite des éléments avant l’histoire. Liez dans le texte chaque image, clip ou piste envoyé à un rôle ; un nom imprimé dans une image de référence ne suffit pas à établir cette correspondance.
- Envoyez les éléments visuels et audio dans un ordre réfléchi.
- Utilisez les étiquettes du point de terminaison :
@Image1,@Video1,@Audio1. - Dites précisément ce qu’il faut reprendre de chaque élément.
- Faites suivre la correspondance d’un résumé de la scène et de l’ordre des plans ou de repères temporels.
Pour une image de sac à dos, une image de campement et un clip avec un arc de caméra, choisissez 12 secondes :
@Image1 supplies the backpack's design, straps and color.
@Image2 supplies the campsite and morning light.
Use only the camera arc from @Video1, not its subjects or background.
A backpack stands upright on a flat rock at the campsite.
0-4s: Establish the bag from the side; a loose strap moves gently in the breeze.
4-9s: Follow the reference camera arc toward the front of the bag.
9-12s: Stop the camera and hold on the front view.
Preserve the bag design while matching it to the campsite's light.
Sound: soft wind and distant birds, without music, dialogue or captions.
Utiliser une répétition de caméra 3D sommaire
Envoyez un clip de rendu en pâte à modeler comme référence vidéo. Précisez s’il faut reprendre sa trajectoire de caméra, le mouvement du sujet, la mise en place ou l’éclairage. Si une image fournit le sujet final, associez-le explicitement à l’objet correspondant dans la répétition.
Retirez du clip les surimpressions de l’éditeur, les axes de coordonnées et les repères de caméra visibles. Décrivez la scène finale autant que les rôles des références, en gardant l’action demandée compatible avec la répétition.
Choisir un storyboard ou des images clés séparées
Une grille de storyboard transmet l’ordre général des plans ; des images séparées peuvent transmettre la composition de chaque image clé. Pour une grille, utilisez des cases nettes et complétez dans le prompt le mouvement et le son manquants. Pour des images clés séparées, indiquez explicitement leur ordre, puis décrivez les transitions.
Attribuer voix et actions sans ambiguïté
Avec plusieurs personnages, donnez à chacun un nom stable et associez séparément apparence et voix. Si une piste audio guide la séquence, dites si @Audio1 fournit la voix, le rythme ou l’ambiance. Ne réécrivez pas une référence de mouvement précise en étapes qui la contredisent ; précisez le rôle de la référence et ajoutez seulement l’information manquante.
Limites de contenu
Seedance 2.5 · Références vers vidéo — Sans censure. SpicyAPI n’ajoute aucun filtre de contenu côté plateforme. Les restrictions du modèle s’appliquent toujours et les résultats ne sont pas garantis. Vous êtes responsable du respect de notre politique de contenu.
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.5/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"generate_audio": true,
"output_format": "mp4",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
