Guide d'utilisation
Guide d'intégration de Seedance 2.5 Flash image-vers-vidéo : première image, dernière image et facturation à la seconde
Faire bouger une image : paramètres, prix et causes d'échec courantes
- Modèle
- seedance-2.5-flash
Sur cette page
Ce que fait ce modèle
seedance-2.5-flash/image-to-video est le modèle image-vers-vidéo de ByteDance : vous téléversez une image comme première image, et le modèle la prend comme point de départ pour générer une séquence vidéo continue, avec génération simultanée de l'audio. Le rapport d'image suit la première image, sans recadrage secondaire.
Il convient aux cas où l'on part de contenus déterministes : présentation animée de visuels produits, micro-expressions et gestes corporels à partir d'illustrations de personnages, prévisualisation animée de storyboards, courts métrages à produire en série pour alimenter un catalogue de contenus. Il ne convient pas aux besoins du type « générer un récit complet à partir d'une simple phrase » : c'est le rôle de la filière texte-vers-vidéo.
Paramètres de requête
- prompt (obligatoire) : décrit les mouvements, les mouvements de caméra, la scène et le son souhaités, jusqu'à 5000 caractères.
- first_frame_url (obligatoire) : image de la première frame. Formats pris en charge : jpeg, png, webp, bmp, tiff, gif, heic, heif ; 30 Mo maximum par image ; de 300 à 6000 pixels par côté ; rapport largeur/hauteur de 0,4 à 2,5.
- last_frame_url (facultatif) : image de la dernière frame, avec les mêmes contraintes que la première image ; en cas de rapport différent, un recadrage centré est appliqué pour l'alignement. Si vous fournissez une dernière image, vous devez aussi fournir la première image.
- resolution :
480pou720p, par défaut480p. - duration : entier de 4 à 30, par défaut 5, en secondes.
- aspect_ratio : accepte uniquement
adaptive; le rapport de sortie suit l'image de la première frame. - output_format :
mp4(par défaut) oumov. - generate_audio :
truepar défaut.
Facturation à la seconde
- 480p : 0,0679 $/seconde
- 720p : 0,1525 $/seconde
Le nombre de secondes facturées est égal à la durée (duration) demandée. Quelques paliers courants : 480p 4 secondes 0,2716 $, 720p 4 secondes 0,61 $, 480p 10 secondes 0,679 $, 720p 10 secondes 1,525 $. Les images de première et de dernière frame ne sont pas facturées en supplément.
Comme la facturation se fait à la seconde, chaque nouvelle tentative est un nouveau paiement. Mieux vaut juger « si la première image convient » avant de soumettre : c'est bien moins coûteux que de recommencer après génération.
La première image fixe la limite de qualité du rendu final
Le modèle ne peut prolonger que les informations déjà présentes dans la première image ; la qualité de celle-ci détermine donc presque entièrement la limite du résultat :
- Sujet net et occupant une proportion raisonnable de l'image : si le sujet est trop petit, le modèle a du mal à déterminer ce qui doit bouger.
- Éviter les flous marqués et le bruit : une entrée de faible qualité sera amplifiée à chaque frame.
- Attention aux bords de l'image : un sujet coupé se déforme facilement lors du mouvement.
- Le texte présent dans l'image reste difficile à stabiliser en mouvement, sauf s'il n'est de toute façon pas l'élément important.
- Préparer plusieurs images candidates de première frame pour un même sujet est plus efficace que de retoucher sans cesse le prompt.
La durée est à la fois un coût et une variable de qualité
Plus le clip est long, plus le modèle doit maintenir la cohérence sur un grand nombre de frames, et plus la probabilité cumulée de dérive et de distorsion augmente. Il est conseillé de valider d'abord sur 4 à 5 secondes si la première image et la direction du mouvement fonctionnent, puis d'allonger si nécessaire ; pour du contenu long, mieux vaut organiser en « plusieurs clips courts + montage en post-production » plutôt que de dépendre d'une seule génération longue.
Échecs courants et ordre de diagnostic
- Erreur de paramètre dès la soumission : vérifiez d'abord si l'image dépasse les limites (taille, dimensions, rapport largeur/hauteur, format), et si vous n'avez fourni que
last_frame_urlsans la première image. - Déformation du sujet dans l'image : c'est le plus souvent que le sujet de la première image est trop petit, que ses bords sont coupés, ou que l'amplitude du mouvement demandée est trop grande. Changez de première image ou réduisez l'action décrite.
- Rapport différent de l'attendu : cette filière est fixée sur
adaptive, la sortie suit la première image ; si vous voulez du 16:9 ou du 9:16, définissez-le dès la première image. - Contenu bloqué : la première image doit elle aussi passer la modération de conformité ; ce qu'elle contient détermine directement si l'appel peut aboutir.
- Délai dépassé côté client alors que la tâche a réussi : la génération vidéo prend du temps ; un délai client trop court fait passer un succès pour un échec, et une nouvelle soumission entraîne une nouvelle facturation. Traitez donc la tâche en asynchrone et accordez un délai suffisant.
Conseils de mise en production
Commencez par valider la chaîne complète avec trois à cinq premières images de types différents, en vérifiant que la soumission, le polling et le téléchargement fonctionnent de bout en bout ; puis fixez la première image et ne modifiez que le prompt, pour identifier quelles descriptions d'actions le modèle suit bien ; enfin, augmentez le volume proportionnellement en surveillant le taux de réussite, la durée moyenne et le taux de nouvelles tentatives. Les paramètres et les prix font foi selon les indications actuelles de la page du modèle.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Guide d'intégration de la génération de vidéo à partir de références avec Seedance 2.5 Flash : images de référence, audio de référence et règles de facturation
-
Guide d'utilisation
Guide d'intégration de Seedance 2.5 Flash text-to-video : paramètres, facturation à la seconde et bonnes pratiques d'ingénierie
D'une requête à une mise en production stable : comment régler les paramètres et calculer les coûts
-
Guide d'utilisation
Guide de démarrage pour kling-image-4.0 : points clés d'intégration de l'API de génération d'images et maîtrise des coûts
Décisions d'intégration et liste de vérification pratique pour les développeurs