Comment utiliser Seedance 2.5 | Champs, limites, facture
Comment utiliser Seedance 2.5 via l'API hébergée : chaque champ et ses limites, les règles des références, la boucle de polling, les secondes facturées, 80006.
Savoir utiliser Seedance 2.5, c'est surtout connaître la forme de sa requête. Un appel porte un prompt, quatre réglages de sortie et jusqu'à trois types de médias de référence ; la plateforme renvoie un identifiant de tâche ; la vidéo finie se récupère par polling. Les mécanismes qui diffèrent de l'ancienne version sont le plafond de 30 secondes, la taille du budget de références, et une règle de facturation qui rend la vidéo de référence plus chère que ne le laisse croire la grille tarifaire.
Confirme que tu es sur la 2.5 avant toute chose
Plusieurs hébergeurs ont gardé Seedance 2.0 comme valeur par défaut en ajoutant la 2.5 à côté, donc c'est la chaîne de modèle qui décide de ce que tu reçois. La build 2.5 sortie est servie sous un identifiant se terminant par -face. Les anciens exemples de code citent un identifiant sans ce suffixe, qui ne résout plus.
Une deuxième vérification ne demande aucune relecture de code. Soumets une requête pour une génération de 20 secondes. Sur la 2.0 elle est rejetée sur le champ de durée, avant qu'une tâche existe, donc rien n'est débité.
Utiliser Seedance 2.5 via l'API hébergée
Une requête de génération prend les champs suivants.
| Champ | Plage | Par défaut |
|---|---|---|
prompt | jusqu'à 20,000 caractères | aucune |
duration | 4 à 30 secondes, ou -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true ou false | true |
content_filter | true ou false | true |
Le prompt est obligatoire pour le text-to-video et optionnel dès qu'un média de référence est présent. Les lignes entre guillemets à l'intérieur sont générées en voix, dans la même passe que l'image, sous forme d'une piste mono couvrant dialogues, effets et musique.
Mettre duration à -1 confie la décision de durée au modèle. La réservation est prise au plafond de 30 secondes, donc prévois le budget d'un clip complet quand tu t'en sers.
Au-delà de ceux-là, la requête expose output_format pour mp4 ou mov, ainsi que bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type et un tableau tools. return_last_frame est le champ qui compte pour le chaînage, puisque la dernière image d'une génération est ce qui amorce la suivante.
Les règles de médias de référence qui font rejeter une requête
La validation des médias de référence est stricte et se déclenche avant la création d'une tâche, ce qui rend un rejet gratuit mais aussi facile à répéter.
- Images : jusqu'à 30 par requête, en jpeg, png, webp, bmp, tiff, gif, heic ou heif, sous 30 MB chacune.
- Vidéo : jusqu'à 10 clips, en mp4 ou mov, 200 MB ou moins chacun, 2 à 30 secondes chacun, 30 secondes cumulées.
- Audio : jusqu'à 10 pistes, en wav ou mp3, 15 MB ou moins chacune, 2 à 30 secondes chacune, 30 secondes cumulées.
Chacun de ces fichiers est une URL HTTP(S) publique. Les data URI sont rejetées sur toute la plateforme, donc héberge le fichier d'abord.
Les images et l'audio de référence n'ajoutent rien à la facture. La vidéo de référence, si, de deux façons, ce qui fait l'objet de la section suivante.
Calculer la facture avant d'envoyer
La facturation se fait à la seconde de vidéo finie, à un tarif fixé par la résolution et par la présence ou non d'une vidéo de référence attachée.
| 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 |
Les secondes facturées sont le plus grand de deux chiffres : la durée de la vidéo de référence arrondie au supérieur plus la durée de sortie, ou les cinq tiers de la durée de sortie arrondis au supérieur.
Deux exemples chiffrés montrent pourquoi ça compte.
Une génération de dix secondes en 1080p sans clip de référence fait facturer dix secondes à $0.461856, soit environ $4.62.
La même sortie de dix secondes en 1080p avec un clip de référence de six secondes fait facturer le plus grand de 16 secondes et 17 secondes, donc 17 secondes à $0.275904, soit environ $4.69. Le tarif plus bas est annulé par le plancher.
Une tâche plus petite montre l'effet plus nettement. Une sortie de cinq secondes en 720p avec un clip de référence de trois secondes fait facturer neuf secondes au lieu de huit, soit environ $1.44, là où les mêmes cinq secondes générées depuis zéro font un peu plus de $1.33.
Polling, délais et remboursements
La tâche est asynchrone. La soumission renvoie un identifiant de tâche, et la vidéo se récupère en interrogeant cette tâche jusqu'à ce qu'elle se déclare terminée.
La génération prend en moyenne deux à cinq minutes. Le polling est gratuit, donc un intervalle fixe de quinze à vingt secondes est raisonnable et il n'y a aucun avantage à espacer agressivement les appels.
Les tâches échouées sont intégralement remboursées. Les chiffres d'usage d'une tâche échouée montrent si le montant réservé est bien revenu, ce qui mérite d'être vérifié quand un lot s'est mal comporté.
Lire un refus
Les refus de sécurité renvoient l'erreur 80006. L'erreur n'identifie pas l'étage qui s'est déclenché, donc la cause peut être le prompt, un fichier de référence ou la sortie générée.
Commence par le prompt. Les célébrités réelles nommées, la propriété intellectuelle de tiers et les contenus illégaux sont bloqués à l'intérieur du modèle, et aucun réglage d'hébergeur ne les retire. Vérifie ensuite les images de référence, puisqu'un visage ou un logo présent dans une photo fournie peut déclencher le même résultat que le fait de le nommer.
content_filter vaut true par défaut. Le passer à false achemine la requête par un canal moins restrictif et ne désactive pas la modération. C'est un contrôle d'acheminement plutôt qu'un interrupteur, et l'ancien alias nsfw_checker passe encore la validation.
Questions fréquentes
Quelle chaîne de modèle faut-il appeler pour Seedance 2.5 ?
La build sortie porte un identifiant se terminant par -face. Les identifiants sans ce suffixe viennent d'exemples d'avant-sortie et ne résolvent plus.
Comment générer un clip de plus de 30 secondes ?
Tu enchaînes les générations. Trente secondes est le plafond par requête, donc les pièces plus longues sont des tâches séparées raccordées au montage, avec return_last_frame qui te donne un point de passage propre.
Pourquoi une vidéo de référence a-t-elle coûté plus que ne l'indiquait la grille tarifaire ? Le clip de référence est facturé pour sa propre durée en plus de la sortie, et la requête n'est jamais facturée en dessous des cinq tiers de la durée de sortie, arrondis au supérieur. Le plus grand des deux chiffres devient le nombre de secondes facturées.
Couper le filtre de contenu laisse-t-il tout passer ?
Non. Passer content_filter à false sélectionne un canal moins restrictif et la modération s'applique toujours. Les blocages au niveau du modèle sur les célébrités réelles, la propriété intellectuelle de tiers et les contenus illégaux restent en place dans tous les cas.
En bref
Utiliser Seedance 2.5, dans l'ordre : vérifie la chaîne de modèle en -face, fixe la durée entre 4 et 30 secondes, choisis une résolution et un format d'image, laisse l'audio activé sauf si tu veux du silence, attache les images de référence sans compter puisqu'elles sont gratuites, soumets, puis interroge la tâche toutes les quinze secondes pendant deux à cinq minutes. Chiffre la tâche sur les secondes facturées plutôt que sur les secondes de sortie dès qu'une vidéo de référence est impliquée, et considère l'erreur 80006 comme un remboursement doublé d'une réécriture.
