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
- Modèle
- seedance-2.5-flash
Sur cette page
Ce que fait ce modèle
seedance-2.5-flash/reference-to-video est un modèle vidéo de ByteDance piloté par des ressources de référence. Vous lui fournissez des images et un audio de référence, puis vous les désignez dans l'ordre dans le prompt avec @image1, @audio1 ; le modèle génère à partir de là une nouvelle vidéo. Les images de référence déterminent l'apparence des personnages, des produits ou des scènes, tandis que l'audio de référence fournit le rythme, la musique ou la voix off.
Contraintes sur les ressources de référence
- Images de référence : 10 au maximum, formats jpeg, png, webp, bmp, tiff, gif pris en charge, chaque fichier inférieur à 30 Mo, côté entre 300 et 6000 pixels, rapport largeur/hauteur entre 0,4 et 2,5 ; SVG, HEIC et HEIF ne sont pas pris en charge.
- Audio de référence : 5 segments au maximum, wav ou mp3, moins de 15 Mo, chaque segment de 2 à 30 secondes, pour un total ne dépassant pas 30 secondes ; il est possible de fournir uniquement de l'audio, sans images.
Au moins l'un des deux types de ressources doit être fourni, sinon la requête n'est pas valide.
Règles de facturation
Cette offre est facturée au nombre de secondes de la vidéo de sortie ; les images et l'audio de référence ne sont pas comptés dans les secondes facturées :
- 480p : 0,0679 $/seconde, soit environ 0,34 $ pour une vidéo de 5 secondes.
- 720p : 0,1525 $/seconde, soit environ 0,76 $ pour une vidéo de 5 secondes.
Si la durée est un entier de 4 à 30, la facturation se fait sur le nombre de secondes indiqué ; si vous saisissez -1 (automatique), la facturation se fait sur la durée réelle de la vidéo arrondie, avec un minimum de 4 secondes. Pour maîtriser votre budget, indiquez une durée fixe en secondes.
Paramètres de la requête
- prompt (obligatoire) : explique comment utiliser les ressources, en les désignant dans l'ordre avec @image1, @audio1, 5000 caractères maximum.
- reference_image_urls / reference_audio_urls : tableaux d'URL des images et de l'audio de référence.
- duration : entier de 4 à 30, ou
-1pour automatique ; valeur par défaut 5. - resolution :
480pou720p, valeur par défaut480p. - aspect_ratio : 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, ou
adaptivepour suivre les ressources de référence, valeur par défautadaptive. - omni_reference_task_type : fixé à
reference(valeur par défaut, peut être omis). - output_format :
mp4(par défaut) oumov; generate_audio : par défauttrue, génère des dialogues, effets sonores et sons d'ambiance synchronisés.
Comment rédiger le prompt
Numérotez d'abord les ressources dans leur ordre d'apparition, puis précisez pour chacune son rôle et l'aspect final de l'image. Par exemple :
Le produit de @image1 est posé sur une table en bois et tourne lentement pour être présenté, l'arrière-plan est la fenêtre au petit matin de @image2,
la caméra avance lentement d'un plan moyen vers un gros plan, le rythme de l'image suit la batterie de @audio1, en conservant les reflets métalliques du produit.
Avec plusieurs images de référence, indiquer clairement laquelle est le sujet et laquelle sert de scène ou de style est bien plus stable que d'écrire simplement « référez-vous à ces images ». Si vous utilisez un audio de référence, précisez à quel passage de l'audio les actions de l'image doivent correspondre.
Questions fréquentes
- Requête refusée pour ressources manquantes : il faut au moins une image de référence ou un audio de référence.
- Impossible de téléverser une image de référence : vérifiez d'abord que le format figure dans la liste prise en charge, que les pixels par côté sont entre 300 et 6000 et que le rapport largeur/hauteur est entre 0,4 et 2,5.
- Audio refusé : chaque segment doit faire entre 2 et 30 secondes et moins de 15 Mo, et le total des segments ne doit pas dépasser 30 secondes.
- Coût différent de celui attendu : vérifiez si vous avez utilisé la durée automatique
-1, car la durée automatique est facturée sur le nombre réel de secondes de la vidéo.
Conseils de mise en production
Commencez par une seule image de référence et une vidéo de 5 secondes en 480p pour valider la chaîne et le mode de facturation ; ajoutez ensuite un audio de référence ou plusieurs images de référence dans une seconde exécution, et vérifiez si l'image utilise les ressources selon les numéros indiqués dans le prompt. Conservez les enregistrements de ces deux exécutions comme référence de base pour comparer lorsque vous modifierez ensuite le prompt ou les ressources. Les paramètres et les prix sont ceux indiqués actuellement sur la page du modèle.
Articles similaires
Voir tous les articles →-
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
-
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