Seedance 2.5 Reference to Video

Que fait Seedance 2.5 Reference to Video ?

Vidéo 1080p guidée par des références, par ByteDance. Fournissez-lui les images qui doivent rester stables, un court clip qui porte le mouvement de la caméra, et un prompt qui dirige l'action — il renvoie un clip 1080p de qualité livraison avec un son synchronisé.

runcomfy.com · Seedance 2.5 Reference to Video 1080p · Niveau brouillon 480p · Documentation CLI

Installer cette compétence

npx skills add genmedia-labs/skills --skill seedance-2-5-reference-to-video -g

Quand choisir ce modèle (vs. ses homologues)

La propriété distinctive de Seedance 2.5 Reference to Video est la génération conditionnée par des références à la résolution de livraison : l'identité, la géométrie du produit et la direction artistique proviennent de votre ensemble de références plutôt que d'une description textuelle, et la sortie est en 1080p, vous évitant ainsi un upscaling. RunComfy le positionne pour les plans finals cohérents avec des personnages, les films de référence de produits, et les clips de marque verrouillés sur un style.

Vous voulez	Utilisez
Même personnage / produit à travers plusieurs plans, en résolution finale	Seedance 2.5 Reference to Video 1080p
Mouvement de caméra et rythme copiés à partir d'un clip existant	Seedance 2.5 Reference to Video 1080p (videos)
Style de marque verrouillé par un moodboard, non décrit textuellement	Seedance 2.5 Reference to Video 1080p (images)
Itération économique pour savoir quelles références fonctionnent	Seedance 2.5 Reference to Video 480p
Aucune référence — prompt uniquement	Seedance 2.5 Text to Video 1080p
Animer exactement une image fixe	Seedance 2.5 Image to Video 1080p
L'ancienne génération 2.0 (4-15s, 480p/720p)	Seedance 2.0 Pro — voir seedance-v2

Si l'utilisateur a explicitement dit "Seedance 2.5" ou "reference to video", orientez ici.

Prérequis

1. Interface CLI RunComfy — npm i -g @runcomfy/cli (ou npx -y @runcomfy/cli)
2. Compte RunComfy — runcomfy login ouvre un flux de code d'appareil dans le navigateur
3. CI / conteneurs — définissez RUNCOMFY_TOKEN=<token> au lieu de runcomfy login
4. URLs de référence accessibles publiquement — le serveur du modèle les récupère, pas votre machine

Pour une plongée approfondie dans l'interface CLI : compétence runcomfy-cli.

Point d'accès + schéma d'entrée

bytedance/seedance-2.5/reference-to-video/1080p

Champ	Type	Requis	Défaut	Remarques
prompt	string	oui	—	Description de la scène qui utilise les références comme indices. Environ 500 caractères en chinois ou 1000 mots en anglais recommandé.
videos	tableau (URIs vidéo)	non	—	0 à 3 clips de référence pour le mouvement de la caméra et le rythme. MP4/MOV, environ 2 à 15 s chacun. Optionnel en pratique — voir ci-dessous.
images	tableau (URIs image)	non	—	0 à 9 images de référence pour l'identité, l'apparence, le style, l'environnement. JPEG/PNG/WebP/BMP/TIFF/GIF.
audios	tableau (URIs audio)	non	—	0 à 3 pistes audio de référence pour l'ambiance et le rythme. WAV/MP3, environ 2 à 15 s, moins de 15 Mo.
aspect_ratio	énuméré	non	16:9	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive.
duration	int	non	5	4 à 30 secondes, par pas de 1 seconde.
generate_audio	booléen	non	true	Parole, effets sonores et musique natifs synchronisés en une seule passe.

La résolution de sortie est fixée à 1080p — il n'y a pas de champ resolution sur ce point d'accès.

videos est optionnel, malgré ce que le schéma indique. Le schéma d'entrée publié liste videos comme requis avec un minimum d'1 élément, mais le point d'accès accepte et complète un corps prompt-plus-images sans aucune clé videos. Envoyez des clips de référence lorsque vous souhaitez que le mouvement de la caméra et le rythme soient copiés à partir d'un plan existant ; omettez-les lorsque vos références sont des images fixes. Les omettre supprime également la durée de la référence de la facturation : les secondes comptées se limitent alors à la durée de sortie seule, donc un clip de 5 s coûte 2,65 $ au lieu de 5,30 $.

Les noms de paramètres ont changé depuis la version 2.0. Seedance 2.0 Pro utilisait image_url / video_url / audio_url. Seedance 2.5 utilise images / videos / audios. Copier un corps de requête 2.0 textuellement produit une erreur de schéma (code de sortie 65).

Tarification

La facturation est de 0,53 $ par seconde vidéo comptée, où les secondes comptées = durée de la vidéo de référence + durée de la sortie. Les références d'images et audio ne sont pas facturées en tant que durée.

Tâche	Secondes comptées	Coût
Sortie de 5 s, sans clip de référence	5	2,65 $
Sortie de 5 s, avec un clip de référence de 5 s	10	5,30 $
Sortie de 10 s, avec un clip de référence de 6 s	16	8,48 $
Sortie de 10 s, avec trois clips de référence de 10 s	40	21,20 $

Deux conséquences qui méritent une action : coupez les clips de référence avant de les télécharger (une référence de 15 s coûte autant que 15 s de sortie), et utilisez le niveau 480p pour la sélection des références — il facture 0,12 $ par seconde comptée avec des vidéos de référence, 0,20 $ par seconde de vidéo générée sans elles.

Comment invoquer

Appel minimum viable — prompt plus un clip de référence :

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "Lent push-in dans l'allée, particules de poussière dérivant dans une lumière latérale chaude, faible profondeur de champ, mouvement fluide continu, pas de texte, pas de filigrane.",
    "videos": ["https://votre-cdn.example/mouvement-camera-6s.mp4"]
  }' \
  --output-dir ./out

Plan final avec personnage cohérent — identité à partir d'images fixes, mouvement à partir d'un clip :

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "La femme des images de référence marche vers la caméra et s'arrête, regardant hors cadre. Suivi à l'épaule, lumière douce et nuageuse, ambiance de rue calme. Pas de texte, pas de filigrane.",
    "images": [
      "https://votre-cdn.example/hero-face.jpg",
      "https://votre-cdn.example/hero-profil.jpg",
      "https://votre-cdn.example/garde-robe.jpg"
    ],
    "videos": ["https://votre-cdn.example/suivi-epaule-4s.mp4"],
    "duration": 8,
    "aspect_ratio": "9:16"
  }' \
  --output-dir ./out

Ensemble complet de références — ajoutez "audios": ["https://votre-cdn.example/ambiance-8s.mp3"] au corps ci-dessus pour fournir au modèle une référence de rythme et d'ambiance, et définissez "generate_audio": true (valeur par défaut) pour obtenir de la parole, des effets sonores et de la musique en une seule passe.

Le CLI soumet la requête, interroge le statut, récupère le résultat et télécharge les URLs *.runcomfy.net / *.runcomfy.com dans --output-dir. Ctrl-C annule la requête distante avant de se fermer.

Rédaction du prompt — ce qui fonctionne vraiment

Laissez les références ancrer, laissez le prompt diriger. Tout ce qui doit rester stable — visage, garde-robe, géométrie du produit, palette de la marque — doit être dans images. Tout ce qui évolue — action, caméra, changement d'éclairage, ambiance — doit être dans prompt. Décrire un visage en prose tout en fournissant une référence de visage produit une dérive, pas un renforcement.

Les vidéos de référence transportent le mouvement de la caméra et le rythme, pas le contenu. Un plan de suivi à l'épaule de 4 s apprend le mouvement au modèle. Ne vous attendez pas à ce qu'il transfère le sujet ; c'est le rôle de images.

Gardez les médias de référence courts. Environ 2 à 15 s par clip et par fichier audio, audio de moins de 15 Mo. Les longs clips sont rejetés et, sur ce point d'accès, gonflent également la facture.

Nommez chaque source sonore lorsque generate_audio est activé : qui parle, ce qui fait chaque bruit, quelle est l'ambiance. "Ambiance de rue calme, trafic lointain, pas de musique" est mieux que "bon son".

Utilisez des instructions négatives. "Pas de texte, pas de filigrane" est le modèle utilisé par l'exemple de prompt de RunComfy, et ça fonctionne. Ajoutez "pas de tremblement de caméra", "pas de personnes supplémentaires" si nécessaire.

Faites correspondre les rapports d'aspect. Des médias de référence dans un rapport différent de aspect_ratio invitent aux recadrages. Utilisez adaptive lorsque vos références ne sont pas d'accord et que le cadre exact n'a pas d'importance.

Anti-patrons :

• Neuf images de référence provenant de neuf esthétiques sans rapport — choisissez un langage visuel.
• Un clip de référence de 15 s alors que 4 s portent le mouvement — vous payez pour les 15.
• Demander 30 s à partir d'un prompt avec un seul temps fort — les longues durées nécessitent un arc décrit.
• Réutiliser un corps Seedance 2.0 avec image_url / video_url — mauvais noms de champ.

Brouillon en 480p, livraison en 1080p

Les conseils de RunComfy pour cette famille de modèles sont de valider l'ensemble de références en basse résolution et de réutiliser la combinaison gagnante à la résolution de livraison. Les deux points d'accès prennent les mêmes paramètres.

1. Assemblez les références candidates. Lancez 3 à 5 variantes sur bytedance/seedance-2.5/reference-to-video/480p avec duration: 5.
2. Évaluez la tenue de l'identité, l'adéquation de la caméra et l'ajustement audio — pas la netteté.
3. Relancez le corps gagnant textuellement sur .../reference-to-video/1080p, en augmentant duration seulement une fois que le rythme est bon.

À 0,12 $ par seconde comptée sur 480p contre 0,53 $ sur 1080p, cinq brouillons coûtent à peu près ce qu'un final 1080p coûte.

Où il excelle

Cas d'utilisation	Pourquoi ce point d'accès
Plans finals avec personnages cohérents	Jusqu'à 9 références d'identité maintiennent le visage et la garde-robe à travers les plans
Films de référence de produits	La géométrie provient d'images fixes ; le mouvement de rotation provient d'un plan
Clips de marque verrouillés sur un style	Un moodboard dans images bat un paragraphe d'adjectifs de style
Prévisualisation qui survit jusqu'à la livraison	Sortie native 1080p, pas d'étape d'upscaling
Dialogue et ambiance en une seule passe	generate_audio produit parole, effets sonores et musique synchronisés

Limitations

• Une vidéo de référence est obligatoire sur ce point d'accès (1 à 3 clips, minimum d'1 élément).
• La 1080p est fixe — pas de paramètre de résolution, pas de variante 720p de ce point d'accès.
• La durée est limitée à 30 s, minimum 4 s, secondes entières uniquement.
• Limites des médias de référence : environ 2 à 15 s par fichier vidéo et audio, audio de moins de 15 Mo, au maximum 9 images / 3 vidéos / 3 pistes audio.
• La durée du clip de référence est facturable — ce point d'accès n'est pas tarifé sur la seule sortie.
• Pas de paramètre de seed sur ce point d'accès, donc la reproduction exacte entre les appels n'est pas garantie.

Quand utiliser un autre point d'accès

• Aucune référence, prompt uniquement → seedance-2.5/text-to-video/1080p, facturé 0,88 $ par seconde de vidéo générée.
• Exactement une seule image fixe à animer → seedance-2.5/image-to-video/1080p, également 0,88 $ par seconde, prend une seule image.
• Autres familles reference-to-video : Wan 3.0 Prime Reference to Video · MiniMax H3 Reference to Video.
• Synchronisation labiale à partir de votre propre piste vocale → ai-avatar-video. Au-delà de 30 s → video-extend.

Codes de sortie

code	signification
0	succès
64	mauvais arguments CLI
65	mauvais JSON d'entrée / non-concordance de schéma (noms de champs 2.0, duration hors limite, aspect_ratio invalide)
69	erreur 5xx en amont
75	réessayable : timeout / 429
77	non connecté ou jeton rejeté

Référence complète : docs.runcomfy.com/cli/troubleshooting.

Comment ça fonctionne

La compétence construit un corps JSON correspondant au schéma ci-dessus et exécute runcomfy run bytedance/seedance-2.5/reference-to-video/1080p. Le CLI effectue une requête POST vers https://model-api.runcomfy.net/v1/models/bytedance/seedance-2.5/reference-to-video/1080p, interroge le statut de la requête, récupère le résultat, et télécharge toute URL de sortie .runcomfy.net / .runcomfy.com dans --output-dir.

Sécurité et confidentialité

• Installez uniquement via un gestionnaire de paquets vérifié. Utilisez npm i -g @runcomfy/cli ou npx -y @runcomfy/cli. Les agents ne doivent pas exécuter un script d'installation distant dans un shell au nom de l'utilisateur.
• Stockage du jeton : runcomfy login écrit le jeton API dans ~/.config/runcomfy/token.json avec le mode 0600. Dans un environnement CI, définissez RUNCOMFY_TOKEN. Ne divulguez jamais le jeton dans les prompts, les journaux ou les fichiers de sortie.
• Données en transit : toutes les communications CLI utilisent HTTPS (TLS 1.3). Les fichiers téléchargés sont servis via des URLs signées temporairement.
• Données au repos : les médias de référence et les vidéos de sortie sont supprimés du serveur RunComfy dans les 24 heures suivant la fin de la tâche. Les invites et les configurations de tâches ne sont pas conservées au-delà de la fenêtre d'exécution.