HiAPI
Blog

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

Nov 17, 2026
Sur un fond charbon chaud, une large bande de lumière ambrée traverse en diagonale, aux bords nets, dans une composition sobre et épurée.
Modèle
seedance-2.5-flash
Sur cette page

Ce que fait ce modèle

seedance-2.5-flash/text-to-video est un modèle text-to-video de ByteDance : il prend en entrée un prompt textuel et produit une vidéo accompagnée d'un audio synchronisé. Il n'existe qu'un seul chemin d'entrée : il n'accepte ni image ni vidéo comme entrée conditionnelle et ne fait pas de compréhension vidéo.

Il convient aux cas où l'on veut « produire en une phrase une petite vidéo exploitable » : production en masse de supports marketing, plans d'ambiance et plans vides pour des vidéos produit, remplissage de segments pour un vivier de contenus, prévisualisation rapide de directions créatives. Si votre point de départ est une image, la voie image-to-video est plus directe ; si vous devez conserver la cohérence du sujet à partir de documents de référence, utilisez la voie pilotée par matériel de référence.

Quels paramètres dans la requête

  • prompt (obligatoire) : scène, sujet, mouvement de caméra et action. Maximum 5000 caractères.
  • resolution : 480p ou 720p, par défaut 480p.
  • duration : entier de 4 à 30, par défaut 5, en secondes.
  • aspect_ratio : 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive, par défaut adaptive (le modèle choisit le ratio en fonction du prompt).
  • output_format : mp4 (par défaut) ou mov.
  • generate_audio : par défaut true, génère dialogues, effets sonores et ambiance synchronisés avec l'image.

Hormis prompt, tous les paramètres ont une valeur par défaut : une requête minimale se contente de prompt. Le corps de requête fait l'objet d'une validation stricte : tout champ non déclaré transmis en trop est rejeté au lieu d'être silencieusement ignoré — ainsi les erreurs apparaissent au moment de la soumission pendant la phase d'intégration, et non après la facturation.

Comment se calcule la facturation à la seconde

La règle de facturation est « prix unitaire par seconde × nombre de secondes produites », liée au palier de résolution :

  • 480p : 0,0679 $/seconde
  • 720p : 0,1525 $/seconde

Le nombre de secondes produites correspond au duration de la requête, sans arrondi inattendu. Exemples : 480p 5 secondes = 0,3395 $, 720p 5 secondes = 0,7625 $ ; 480p 30 secondes = 2,037 $, 720p 30 secondes = 4,575 $. Si la durée double, le coût double : aucune remise « plus c'est long, moins c'est cher ».

Cela implique trois choses : premièrement, l'estimation budgétaire se réduit à une multiplication — fixez d'abord la durée d'un clip puis multipliez par le nombre de clips ; deuxièmement, une nouvelle tentative, c'est un paiement en double — les tentatives en cas d'échec doivent avoir une limite ; troisièmement, ne générez pas un film long en une seule fois : découpez-le en plusieurs clips courts générés séparément puis assemblés, ce qui économise de l'argent et limite l'impact d'un échec au seul segment défectueux.

Forme d'intégration : tâche asynchrone

La génération vidéo est une tâche longue ; l'interface est asynchrone : après soumission, vous obtenez un identifiant de tâche, puis vous interrogez par polling ou attendez un callback pour récupérer le résultat, et enfin vous téléchargez le produit pour le stocker. Ne l'encapsulez pas en RPC synchrone qui bloquerait la requête utilisateur.

  • Persistance de la machine à états : stockez en base l'identifiant de tâche, l'état et les paramètres de requête, pas seulement en mémoire du processus — perdre une tâche au redémarrage revient à payer sans résultat.
  • Backoff de polling : commencez par un intervalle court, allongez progressivement avec du jitter, et fixez un timeout global par tâche ; en cas de dépassement, basculez vers la branche d'échec plutôt que de poller indéfiniment.
  • Classification des erreurs : les erreurs de paramètres et les violations de contenu sont des échecs déterministes, les réessayer n'a pas de sens ; seules les erreurs transitoires comme les aléas réseau ou le rate limiting méritent un backoff avec réessai.
  • Idempotence : côté soumission, portez une clé métier unique pour éviter que des clics répétés de l'utilisateur ne créent plusieurs tâches et une double facturation.

Comment écrire des prompts stables

Rédigez en quatre parties « sujet → enchaînement des actions → environnement et lumière → caméra » ; c'est bien plus stable qu'empiler une série d'adjectifs.

Sujet : un chat blanc assis sur le rebord de la fenêtre, à contre-jour
Action : de l'immobilité à la tête qui se lève vers la fenêtre, la queue oscillant lentement
Environnement et lumière : lumière chaude de l'après-midi, faible profondeur de champ, atmosphère intérieure calme
Caméra : plan moyen, caméra fixe, léger effet caméra à l'épaule

Trois règles : un prompt ne décrit qu'un seul plan continu, n'entassez pas plusieurs changements de scène dans une même génération ; versionnez vos prompts et ne modifiez qu'une variable à la fois, afin de pouvoir identifier quel changement a eu un effet ; validez d'abord sur un petit échantillon avant de passer en série, n'utilisez pas la production en série pour valider un prompt encore instable.

Le format d'image et le langage cinématographique se décrivent en langage naturel — le modèle n'a pas de paramètre « mouvement de caméra » distinct ; écrivez-le dans le prompt, c'est plus fiable que d'attendre un champ inexistant.

Parcours de mise en production

  1. Faire fonctionner la chaîne : trois prompts couvrant des scénarios typiques, vérifiez que soumission, polling et téléchargement fonctionnent de bout en bout, sans juger encore de la qualité du résultat.
  2. Fixer prompts et durées : figez un petit nombre de prompts, comparez les productions selon différentes formulations et durées, enregistrez le coût de chaque clip et constituez une bibliothèque de modèles réutilisables.
  3. Déploiement progressif : montez en charge par paliers, surveillez le taux de réussite, la durée moyenne, le taux de réessai et la courbe des coûts ; n'augmentez le volume qu'une fois les trois premiers indicateurs conformes.
  4. Exploitation courante : passez régulièrement en revue la bibliothèque de modèles, éliminez les formulations inefficaces, surveillez la tendance des coûts et les seuils de réessai.

La page du modèle contient les dernières spécifications de paramètres et les prix ; il suffit de les vérifier avant l'intégration.

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