Comment accéder à Seedance 2.5 | Clé, requête, rendu
Comment accéder à Seedance 2.5 : confirmer la vraie version, obtenir une clé, les champs d'une première requête, les défauts qui coûtent cher, et la facture.
ByteDance a annoncé Seedance 2.5 le 31 juillet 2026, et les hébergeurs l'ont repris à des dates différentes ensuite. C'est ce déploiement échelonné qui rend la question de l'accès à Seedance 2.5 plus difficile qu'elle n'en a l'air : beaucoup de surfaces l'affichent tout en servant encore l'ancien modèle en dessous. Obtenir un premier rendu suppose de confirmer la version, de détenir une clé, et d'envoyer une requête dont tu as réellement lu les valeurs par défaut.
D'abord, confirme que la version est la bonne
Deux vérifications tranchent la question, et aucune ne coûte quoi que ce soit.
Demande 20 secondes. Seedance 2.5 va de 4 à 30 secondes en une seule génération. Seedance 2.0 s'arrête à 15. Une requête de 20 secondes rejetée sur le champ de durée veut dire que tu es sur la 2.0. Un rejet de validation intervient avant la création d'une tâche, donc rien n'est débité.
Lis l'identifiant de modèle. La build 2.5 sortie est servie sous une chaîne se terminant par -face, écrite en entier doubao-seedance-2.5-face. Les exemples de code publiés avant la sortie citent un identifiant sans ce suffixe, et il ne résout plus. Si la documentation d'une plateforme montre encore l'ancienne chaîne, son intégration est antérieure à la sortie.
Une troisième vérification, non concluante mais parlante : si l'interface propose un palier 4K, elle décrit du marketing d'avant-sortie. Le modèle plafonne à 1080p, avec 720p et 480p en dessous, chez tous les hébergeurs.
Prends une clé et un endroit où poser les fichiers
Une clé d'API prise dans le tableau de bord de la plateforme, envoyée dans un en-tête Authorization: Bearer, constitue toute l'authentification. Traite-la comme un moyen de dépense et garde-la sur un serveur.
Si tu comptes utiliser du matériel de référence, il te faut aussi un endroit pour l'héberger. Les entrées média sont exclusivement des URL HTTP ou HTTPS publiques. Les data URI sont rejetées sur toute la plateforme, donc les fichiers locaux doivent être téléversés avant de pouvoir être référencés.
Accéder à Seedance 2.5 avec une première requête
L'appel est un POST vers l'endpoint de génération vidéo de la plateforme. Il renvoie un identifiant de tâche, pas une vidéo. Tu interroges ensuite un endpoint de tâche jusqu'à ce que le statut soit terminal. Le polling est gratuit.
Le corps utile minimal, c'est une chaîne de modèle, un prompt et une durée. Les valeurs par défaut en dessous comptent plus que la plupart des gens ne l'imaginent :
| Champ | Par défaut | À savoir |
|---|---|---|
| Durée | 5 secondes | La plage va de 4 à 30. Mettre -1 laisse le modèle choisir et réserve au plafond de 30 secondes |
| Résolution | 720p | 480p et 1080p sont les deux autres options |
| Format d'image | adaptive | Des formats fixes existent si la sortie vise un cadre précis |
| Audio | activé | Voix, effets et musique sont générés avec l'image |
La durée par défaut de 5 secondes fait un premier rendu raisonnable. La valeur -1 est celle à éviter au début, parce que la réservation est prise au plafond et non sur ce que le modèle finit par produire.
Les prompts vont jusqu'à 20000 caractères. Un prompt est obligatoire pour le text to video et devient optionnel dès qu'un média de référence est attaché.
La porte des médias de référence
C'est la capacité qui sépare la 2.5 de l'ancienne version, et elle est accessible dès la première requête. Une seule tâche accepte jusqu'à 30 images de référence, 10 clips vidéo de référence et 10 pistes audio.
L'asymétrie tarifaire est ce qu'il faut intégrer. Les images de référence et l'audio de référence n'ajoutent rien à la facture. La vidéo de référence, si, et elle le fait deux fois. Un clip source est facturé pour sa propre durée en plus de la sortie, et toute requête contenant de la vidéo porte un plancher de facturation fixé aux cinq tiers de la durée de sortie. Une source de deux secondes avec une sortie de cinq secondes fait facturer neuf secondes au lieu de sept. Chaque clip de référence dure de 2 à 30 secondes et la vidéo de référence cumulée ne peut pas dépasser 30 secondes.
Un premier rendu conditionné sur des images fixes est donc presque exempt de surprises. Un premier rendu conditionné sur du métrage ne l'est pas, et devrait rester petit.
Ce que coûte le premier clip
Les tarifs s'appliquent à la seconde de vidéo finie, fixés par la résolution et par la présence ou non d'un clip de référence dans la requête :
| Résolution | Génération seule | Avec une vidéo de référence |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Un clip de cinq secondes en 480p fait environ $0.59. Un clip de dix secondes en 1080p fait environ $4.62. L'écart entre ces deux chiffres est l'argument pour faire la première tentative courte et petite, vérifier que le prompt fait ce que tu voulais, et seulement ensuite monter la résolution et la durée.
La génération prend deux à cinq minutes. Les tâches échouées sont intégralement remboursées, refus compris.
Quand le premier appel échoue
Un refus de sécurité renvoie l'erreur 80006. Il ne nomme pas l'étage qui s'est déclenché, donc le prompt, n'importe quelle image de référence et la sortie générée sont tous candidats, et le diagnostic est manuel : réduis à un prompt neutre, vérifie qu'il passe, puis remets les éléments un par un.
Le paramètre content_filter vaut true par défaut. Le passer à false achemine la requête vers un canal moins restrictif et ne désactive pas la modération. En dessous se trouvent des blocages au niveau du modèle sur les célébrités réelles nommées, la propriété intellectuelle de tiers et les contenus illégaux, qu'aucun réglage d'hébergeur ne retire.
Tout le reste de la liste des échecs au premier appel relève de la validation : une durée hors de la plage 4 à 30, une chaîne de modèle retirée, une URL en data:, un clip de référence au-delà de la limite de durée. Aucun de ces cas ne crée de tâche, donc aucun ne coûte quoi que ce soit.
Questions fréquentes
Faut-il un compte différent pour accéder à Seedance 2.5 plutôt qu'à la 2.0 ? Non. Les plateformes qui servent les deux les exposent comme des identifiants de modèle distincts sur un seul compte et une seule clé. Passer d'une version à l'autre se résume en général à changer une chaîne.
Comment savoir si une plateforme fait vraiment tourner la 2.5 ?
Demande 20 secondes. Une réussite veut dire 2.5, un rejet sur le champ de durée veut dire 2.0. Vérifie ensuite que l'identifiant de modèle se termine par -face.
Puis-je accéder à Seedance 2.5 sans clé d'API ? Les applications grand public et les intégrations embarquées dans les éditeurs atteignent le modèle sans clé, au prix de l'accès aux paramètres et de la facturation à la seconde. Tu obtiens des préréglages et un solde de crédits à la place.
La 4K est-elle disponible sur un forfait quelconque ? Non. Le modèle sorti plafonne à 1080p. Le chiffre 4K vient d'articles d'avant-sortie portant sur une promesse jamais livrée.
En bref
Accéder à Seedance 2.5 tient en quatre étapes. Vérifie la version avec une requête de 20 secondes et l'identifiant -face. Prends une clé et garde-la côté serveur. Envoie une première tâche courte, cinq secondes en 480p, en laissant les valeurs par défaut tranquilles sauf la durée et la résolution. Interroge la tâche pendant deux à cinq minutes et télécharge le résultat. Les images et l'audio de référence s'attachent gratuitement, la vidéo de référence est facturée pour sa propre durée avec un plancher aux cinq tiers, et tout ce qui échoue est remboursé.
