HiAPI
Blog

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

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
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 -1 pour automatique ; valeur par défaut 5.
  • resolution : 480p ou 720p, valeur par défaut 480p.
  • aspect_ratio : 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, ou adaptive pour suivre les ressources de référence, valeur par défaut adaptive.
  • omni_reference_task_type : fixé à reference (valeur par défaut, peut être omis).
  • output_format : mp4 (par défaut) ou mov ; generate_audio : par défaut true, 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 →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API