Seedance 2.5 référence vers vidéo : utiliser les références
Les références permettent à Seedance 2.5 de garder le même visage, produit, lieu ou style sur tout un clip. Une requête peut contenir jusqu'à 30 images de référence, jusqu'à 10 clips de référence et jusqu'à 10 sons de référence, et le prompt indique à quoi sert chacun.
Limites des références
| Référence | Champ | Jusqu'à | À utiliser pour |
|---|---|---|---|
| Images | image_urls | 30 | Un personnage sous plusieurs angles, un produit, un lieu, une palette de couleurs, une image de storyboard |
| Clips vidéo | video_urls | 10 | Un mouvement de caméra, un jeu d'acteur ou un mouvement à reproduire ; ou le clip à modifier |
| Sons | audio_urls | 10 | Une musique sur laquelle monter, une voix, un effet sonore |
Les références sont des liens https publics, ou des fichiers que vous envoyez avec POST /v1/uploads (images jusqu'à 30 MB, clips 50 MB, sons 15 MB). Une première image (image_url) est autre chose : elle fixe l'image d'ouverture. Voir image vers vidéo.
Nommez chaque référence dans le prompt
Le modèle lit les références dans l'ordre où vous les envoyez. Désignez-les par type et par numéro, et dites à quoi sert chacune : « la femme de l'image 1 », « la bouteille de l'image 3 », « reprends le mouvement de caméra de la vidéo 1 », « la musique suit l'audio 1 ». Une référence que vous ne mentionnez pas peut quand même influencer le rendu : n'envoyez que ce dont le plan a besoin.
# One Idempotency-Key per job, made once: resend with the same $KEY after a timeout, a 429 or a 5xx
KEY=$(uuidgen)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $KEY" \
-d '{
"model": "seedance-2.5",
"input": {
"prompt": "The chef from image 1 plates the dish from image 2 in the kitchen from image 3. Shot 1: wide of the kitchen. Shot 2: close-up of her hands plating. Shot 3: she slides the plate toward camera and smiles. Pans sizzling, low kitchen chatter.",
"image_urls": [
"https://example.com/chef.jpg",
"https://example.com/dish.jpg",
"https://example.com/kitchen.jpg"
],
"duration": 15,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
},
"max_cost_usd": 5
}'Clips et sons de référence
Un clip de référence montre au modèle un mouvement ou un mouvement de caméra à suivre ; un son lui donne le rythme ou la voix à reproduire. On peut les combiner avec des images dans une même requête.
{
"model": "seedance-2.5",
"input": {
"prompt": "Copy the camera move of video 1: a fast dolly through a crowded market, but in a snowy mountain village at dusk. The music follows audio 1.",
"video_urls": [
"https://example.com/dolly-shot.mp4"
],
"audio_urls": [
"https://example.com/track.mp3"
],
"duration": 10,
"resolution": "720p",
"audio": true
},
"max_cost_usd": 5
}Modifier une vidéo existante
Envoyez le clip dans video_urls et décrivez seulement le changement. Ne précisez ni la durée ni le format : la modification garde ceux du clip.
{
"model": "seedance-2.5",
"input": {
"prompt": "Same shot, but it is night and raining, neon reflections on the street",
"video_urls": [
"https://example.com/street.mp4"
]
},
"max_cost_usd": 5
}Pour remplacer une personne, un produit ou un lieu dans un clip en gardant le même jeu et la même caméra, Nemesis est fait exactement pour ça.
Ce que coûtent les références
Les images de référence ne changent pas le tarif : 480p $0.09 · 720p $0.21 · 1080p $0.52 la seconde. Une requête avec vidéo en entrée est facturée au tarif réduit d'entrée vidéo ($0.06, $0.15 et $0.34 la seconde), et les secondes des clips d'entrée sont facturées avec la sortie : un clip de 10 secondes en 720p créé à partir d'une référence de 10 secondes coûte $3.00. L'endpoint de devis gratuit donne le prix exact de n'importe quelle requête.
Conseils pour des personnages et produits cohérents
- Plusieurs angles, un seul sujet. Trois ou quatre images du même visage (de face, de trois quarts, de profil) tiennent mieux un personnage qu'une seule.
- Fonds unis pour les références de produit et de personnage, pour que le modèle ne copie pas aussi l'arrière-plan.
- Un rôle par référence. N'envoyez pas une image qui montre à la fois le personnage et le lieu ; séparez-les.
- Une distribution réduite. Un ou deux personnages restent cohérents plus sûrement qu'une foule.
- Brouillons en 480p ($0.90 pour 10 secondes) jusqu'à ce que les références passent bien, puis rendez la version finale.
FAQ
Combien d'images de référence Seedance 2.5 accepte-t-il ?
Jusqu'à 30 images de référence par requête sur Revana, plus jusqu'à 10 clips et 10 sons de référence.
Quelle différence entre une image de référence et une première image ?
Une première image (image_url) est l'image exacte d'ouverture du clip. Les images de référence (image_urls) guident qui et quoi apparaît, et avec quel rendu, sans fixer aucune image.
Seedance 2.5 accepte-t-il des références audio ?
Oui. Envoyez jusqu'à 10 sons dans audio_urls et indiquez dans le prompt à quoi sert chacun, par exemple la musique sur laquelle monter.
Les références coûtent-elles plus cher ?
Les images de référence, non. Les clips de référence font passer la requête au tarif d'entrée vidéo ($0.15 la seconde en 720p) et leurs secondes sont facturées avec la sortie.
Créez votre première vidéo Seedance 2.5
Une seule clé API pour Seedance 2.5 et tous les autres modèles vidéo et image. Crédit prépayé dès $10, crédit d'inscription gratuit, sans abonnement, et seuls les clips livrés sont facturés.