API Seedance 2.5 : endpoint, paramètres et facturation réelle
L'API Seedance 2.5 est asynchrone, facturée à la seconde, et comporte trois règles de facturation qui prennent les gens au dépourvu. Tout ce qu'il te faut avant d'écrire le premier appel.
À partir de $0.07 par seconde, 480p avec un clip de référence
Ce que l'API Seedance 2.5 te donne
Un POST crée un job, un GET l'interroge, et l'interrogation est gratuite. L'API Seedance 2.5 décide de son mode d'après les champs média que tu remplis, et non d'après un paramètre dédié.
Un prompt seul, c'est du text-to-video. Ajoute des images et l'API Seedance 2.5 fait de l'image-to-video. Ajoute une première et une dernière image et elle anime une transition. Ajoute un clip source et elle édite ou prolonge.
Le POST renvoie immédiatement un identifiant de tâche et la génération prend de deux à cinq minutes. Une intégration de l'API Seedance 2.5 a besoin d'une boucle d'interrogation ou d'une file, pas d'une requête synchrone.
La plateforme le sert sous le nom doubao-seedance-2.5-face. Se tromper de chaîne de modèle est l'échec le plus courant au premier appel à l'API Seedance 2.5, et cela renvoie une erreur synchrone plutôt qu'une facturation.
Un en-tête, une portée d'espace de travail, pas d'identifiant de projet. Une clé d'API Seedance 2.5 porte le périmètre de facturation de l'espace de travail qui l'a émise.
Tout job en échec rend les crédits intégralement, refus de modération compris. L'API Seedance 2.5 ne facture jamais un rendu que tu n'as pas reçu.
Pas de générateur ici. Les appels à l'API Seedance 2.5 tournent sur l'API hébergée, et chaque paramètre et tarif ci-dessous est tiré de sa documentation publiée.
Les paramètres de l'API Seedance 2.5 qui comptent le plus
Quatre champs qui décident du coût et du résultat.
duration
De quatre à trente secondes, cinq par défaut. Passer -1 laisse le modèle choisir, mais l'API Seedance 2.5 réserve les crédits au plafond de 30 secondes et rembourse la différence, ce qui peut déclencher un 402 sur un solde juste.
resolution
480p, 720p ou 1080p, 720p par défaut. Il n'y a pas de 4K sur l'API Seedance 2.5, et en demander une renvoie une erreur plutôt qu'un clip dégradé.
content_filter
Booléen, à true par défaut. False achemine la requête à l'API Seedance 2.5 vers un canal moins restrictif et rend le prompt obligatoire. La plateforme le documente comme du routage et non comme un interrupteur d'arrêt.
omni_reference_task_type
Déclare edit ou extend et l'API Seedance 2.5 valide les règles à la soumission au lieu d'échouer quelques minutes plus tard. À définir sur tout job piloté par des références.
Quatre étapes vers un appel fonctionnel à l'API Seedance 2.5
- 1
Créer une clé
Génère-la dans le tableau de bord de la plateforme et envoie-la comme bearer token. L'API Seedance 2.5 rejette tout le reste sur l'en-tête d'autorisation.
- 2
POSTer le job
Envoie le modèle, le prompt et les URL de médias à l'endpoint videos generations. Tous les champs média de l'API Seedance 2.5 prennent des URL HTTP ou HTTPS publiques ; le base64 est rejeté à l'échelle de la plateforme.
- 3
Interroger la tâche
Fais un GET sur l'identifiant de tâche jusqu'à ce que le statut soit completed ou failed. Interroger l'API Seedance 2.5 ne coûte rien, donc un intervalle de deux secondes convient.
- 4
Lire la sortie
Une tâche terminée de l'API Seedance 2.5 porte les URL de la vidéo, plus une URL de dernière image si tu en as demandé une. Réhéberge tout ce que tu veux garder, car les URL livrées ne sont pas permanentes.
L'API Seedance 2.5, en questions
Par seconde de vidéo facturable, de $0.071153 à $0.461856 selon la résolution et selon que la requête portait un clip de référence. Un rendu de dix secondes en 1080p coûte environ $4.62. Les images de référence et l'audio de référence n'ajoutent rien à la facture.
La durée de sortie, plus la durée complète de toute vidéo de référence, avec un plancher de cinq tiers de la durée de sortie sur toute requête contenant de la vidéo. Une source de deux secondes avec une sortie de cinq secondes facture neuf secondes et non sept, ce qui surprend la plupart des premières intégrations.
doubao-seedance-2.5-face sur l'API hébergée. D'anciens guides citent doubao-seedance-2.5 sans le suffixe, ce qui est antérieur au lancement et ne résout pas. Vérifie la page du modèle plutôt que de faire confiance à un exemple de code.
L'interrogation périodique est la voie documentée et elle est gratuite, donc une boucle à intervalle court est l'intégration la plus simple de l'API Seedance 2.5. Comme la génération prend de deux à cinq minutes, un sondage toutes les deux à cinq secondes n'ajoute aucune charge significative et ne demande aucune infrastructure de callback.
Validation de schéma, et rien n'a été facturé. Les causes courantes sont une résolution invalide, une valeur de taille combinée à une première ou dernière image, ou un prompt manquant sur une requête text-to-video. L'erreur nomme le champ fautif.
Soit une règle de type de tâche, soit la modération. L'erreur 80006 est un refus de sécurité et ne nomme pas l'étape. Un paramètre incompatible sur un job d'édition produit un échec différent, et déclarer omni_reference_task_type transforme cela en 400 immédiat la fois suivante.
Jusqu'à 30 images, 10 clips vidéo totalisant 30 secondes, et 10 pistes audio. Les tableaux d'images simples et d'images avec rôle sont mutuellement exclusifs, donc choisis-en un par requête à l'API Seedance 2.5.
Oui, sur le même endpoint avec un identifiant de modèle différent. Seedance 2.0 plafonne à 15 secondes là où la 2.5 atteint 30, et la forme de la requête est assez proche pour que changer de version soit surtout une affaire de chaîne de caractères.
Une clé porte le périmètre de facturation de l'espace de travail qui l'a émise, et il n'y a pas d'en-tête de projet distinct. Les équipes qui ont besoin d'une comptabilité séparée créent des espaces de travail séparés plutôt que des clés séparées dans un seul, parce que la consommation s'agrège au niveau de l'espace de travail.
Commence par la documentation de l'API Seedance 2.5
Paramètres publiés, tarifs à la seconde en vigueur, interrogation gratuite et remboursement automatique en cas d'échec.
À voir aussi : Seedance 2.5 API