Seedance API : tarification, qualité et configuration pour les points de terminaison officiels

Seedance API : tarification, qualité et configuration pour les points de terminaison officiels

L’API Seedance est utile lorsqu’une équipe a besoin de génération de vidéos courtes à partir de texte, d’images ou de médias de référence, mais la décision d’intégration ne se résume pas à « quel modèle semble le meilleur ? ». Vous devez aussi choisir un point de terminaison, comprendre l’unité de tarification, contrôler la durée et la résolution, et mesurer le coût des clips que vos monteurs ou les utilisateurs de votre produit acceptent réellement.

Ce guide se concentre sur les parcours de configuration officiels qu’une équipe média ou produit peut utiliser aujourd’hui :

• L’API officielle de tâche de génération vidéo de BytePlus ModelArk, qui constitue le chemin direct du fournisseur pour les modèles Seedance.
• La route /v1/videos de Flatkey, qui expose les identifiants de modèles Seedance via une seule clé API, un seul solde et un catalogue de modèles en temps réel.

En bref : utilisez Seedance 2.5 lorsque vous avez besoin de workflows vidéo guidés par référence plus robustes, d’audio optionnel et de sorties de 4 à 30 secondes. Utilisez Seedance 2.0 Pro, Fast ou Mini lorsque vous avez besoin d’une route au coût inférieur par seconde pour des tests à grand volume et que vous pouvez maintenir des critères d’acceptation stricts. Comparez toujours le coût par clip accepté, et pas seulement le prix par seconde.

Si vous comparez encore la qualité des modèles, associez ce guide tarifaire au cadre d’évaluation de l’API Seedance. Si vous comparez les routes des fournisseurs, lisez la revue du routage et de la tarification de l’API Seedance vs Veo. Si vous passez des tests à l’exploitation, gardez la liste de contrôle de production de l’API Seedance ouverte pendant que vous mettez en place les files d’attente, les nouvelles tentatives et les états de révision.

Options de point de terminaison de l’API Seedance

BytePlus ModelArk documente Seedance dans ses sections consacrées à l’API de génération vidéo et à la tarification. Sa page de tarification décrit les modèles de génération vidéo comme utilisant un taux de jetons et un modèle de consommation de jetons, et précise que la consommation finale de jetons est renvoyée après l’appel à l’API via des champs d’utilisation. La même page de tarification indique également un comportement de consommation minimale de jetons pour les séries Seedance 2.0 et les requêtes Seedance 2.5 lorsque l’utilisation estimée tombe en dessous du minimum.

Les pages des modèles Seedance de Flatkey présentent une unité plus simple orientée acheteur pour les routes actuellement dans le catalogue : un prix par seconde, ainsi que les options visibles de durée et de résolution pour chaque page de modèle. Cela facilite la planification d’un budget de test créatif, mais les équipes de production doivent tout de même consigner le modèle soumis, la résolution, la durée, le groupe de compte, le statut final et le résultat accepté/rejeté.

Instantané actuel de la tarification de l’API Seedance sur Flatkey

La tarification ci-dessous a été vérifiée à partir des صفحات de modèles publiques de Flatkey le 13 octobre 2026. Considérez-la comme un instantané de configuration, pas comme un contrat : confirmez toujours la page du modèle en direct avant le lancement ou une exécution par lots importante.

Le tableau donne une estimation de départ. Le coût réel d’une campagne dépend de la durée, de la résolution, des relances, des échecs, des rejets de modération, des modifications par l’utilisateur et du nombre de clips générés qui passent votre niveau d’examen.

Le prix par seconde n’est pas la même chose que le coût créatif

Pour un workflow de génération vidéo, la métrique qui compte est :

accepted_clip_cost =
  total_spend_for_generation_batch
  / number_of_clips_that_pass_review

Par exemple, une route moins chère par seconde peut tout de même être plus coûteuse si elle produit de nombreux clips qui échouent à l’examen de la marque, de la continuité ou des détails du produit. Une route plus chère peut être moins coûteuse lorsqu’elle réduit les reprises et le travail éditorial.

Utilisez cette feuille de calcul simple avant de choisir une route de l’API Seedance :

Choix de configuration entre Seedance 2.5 et Seedance 2.0

Choisissez Seedance 2.5 lorsque votre flux de travail dépend de médias de référence, du contrôle des images, de l’audio facultatif ou de sorties plus longues de 4 à 30 secondes. La page Seedance 2.5 de Flatkey répertorie les flux texte vers vidéo, image vers vidéo et référence vers vidéo sur /v1/videos, avec des options 480p et 720p ainsi qu’une génération audio en option de requête.

Choisissez Seedance 2.0 Pro lorsque vous avez besoin d’une route Seedance 2.0 avec des options de résolution visible plus élevées sur Flatkey et que vous évaluez la qualité créative finale. Choisissez Seedance 2.0 Fast pour la vitesse d’itération et des tests plus larges. Choisissez Seedance 2.0 Mini pour le filtrage à faible coût, le tri des prompts et l’exploration précoce des concepts.

Ne changez pas de modèle sur le seul critère du prix. Exécutez d’abord un petit jeu de tests de qualité :

1. Choisissez 20 prompts à partir de briefs de campagne réels.
2. Incluez au moins cinq prompts difficiles avec des détails produits, des mains, l’emballage, la continuité du mouvement ou des affirmations sensibles à la marque.
3. Générez la même durée et la même résolution sur les routes candidates lorsque c’est possible.
4. Évaluez les clips en aveugle avant de montrer les noms des modèles ou les prix.
5. Suivez les clips acceptés, les clips nécessitant des retouches mineures, les clips rejetés, le nombre de tentatives, la latence de génération et le coût final.

Configuration de l’API Seedance de Flatkey

La route Flatkey simplifie la configuration, car les pages publiques des modèles exposent ensemble l’ID du modèle et la route. Commencez par une petite requête, puis ajoutez la logique de stockage, de relance et de revue.

export FLATKEY_API_KEY="your_flatkey_api_key"
export FLATKEY_BASE_URL="https://router.flatkey.ai"

curl -sS "$FLATKEY_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "Une vidéo de dévoilement de produit soignée sur une table de studio blanche. La caméra se déplace lentement de gauche à droite tandis que l’emballage effectue une rotation complète. Pas de texte, pas de filigrane."
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

Pour l’image vers vidéo ou la référence vers vidéo, ajoutez les entrées multimédias prises en charge depuis la page du modèle ou le flux de travail de la console, puis conservez la même discipline de journalisation. Stockez le modèle soumis, le flux de travail, la version du prompt, les références, la résolution, le ratio, la durée, l’indicateur audio, l’ID de tâche ou l’ID de réponse, le statut final, les dépenses et le résultat de la revue.

Vérifications de configuration de BytePlus ModelArk

Si vous utilisez directement BytePlus ModelArk, suivez la documentation ModelArk actuelle pour la création de la clé API, l’URL de base et l’authentification, la création de tâches de génération vidéo, la récupération des tâches, le listing, ainsi que l’annulation ou la suppression. La forme exacte de la requête et le calculateur de tarification doivent être vérifiés dans la console BytePlus ou dans la documentation au moment du lancement.

Utilisez cette liste de contrôle avant un lancement direct chez le fournisseur :

• Confirmez que le modèle Seedance est activé dans la région requise.
• Confirmez si votre flux de travail est du texte vers vidéo, de l’image vers vidéo, de la référence vers vidéo ou un autre mode spécifique au fournisseur.
• Confirmez si la tarification est basée sur des jetons, sur un forfait ou soumise à un calculateur pour le compte actuel.
• Confirmez le cycle de vie de la tâche : création, interrogation ou récupération, liste, annulation, suppression et états d’échec.
• Confirmez les champs d’utilisation renvoyés, en particulier le champ utilisé pour la consommation finale de jetons.
• Confirmez les règles minimales de consommation de jetons pour votre résolution, votre format d’image, votre durée et le mode d’entrée vidéo.
• Confirmez les exigences de sécurité du contenu, de conservation du stockage et d’URL média.

La différence importante est opérationnelle : ModelArk direct vous donne la surface native du fournisseur, tandis que Flatkey vous offre une surface de compte unique à travers de nombreux modèles et modalités.

Barème de qualité pour les tests de l’API Seedance

La tarification ne devient utile qu’après avoir défini la qualité. Utilisez un barème qui corresponde à la manière dont votre équipe acceptera ou rejettera les clips.

Pour une équipe de production, le résultat de cette grille devrait être une règle d’acheminement. Par exemple :

Utilisez seedance-2.0-mini pour un filtrage préliminaire des prompts.
Utilisez seedance-2.0-fast pour une exploration plus large des concepts.
Utilisez seedance-2.0-pro lorsque la qualité finale 2.0 compte.
Utilisez seedance-2.5 lorsque le contrôle des références, l’audio ou une sortie de 4 à 30 s sont requis.

Configuration de production : quoi consigner dès le premier jour

N’attendez pas que les coûts vous surprennent pour ajouter de l’observabilité. Consignez ces champs dès le premier test de l’API Seedance :

• request_id ou ID de tâche
• user_id, espace de travail, campagne ou compte client
• model
• workflow
• resolution
• ratio
• duration
• generate_audio
• nombre et type de médias de référence
• version du prompt soumis
• statut de la réponse
• code d’erreur du fournisseur ou code d’erreur de la passerelle
• latence jusqu’à la sortie acceptée
• montant facturé ou utilisation retournée
• résultat de la revue : accepté, modifié, rejeté ou en échec

Ces champs permettent aux équipes financières et aux opérations créatives de répondre aux vraies questions : quelle voie produit des clips exploitables, où se produisent les réexécutions, et si une voie plus coûteuse est en fait moins chère pour un type de campagne précis.

Erreurs courantes de configuration de l’API Seedance

Les erreurs les plus coûteuses sont généralement opérationnelles :

• Comparer une voie 480p à une voie 720p ou 1080p et y voir une différence de qualité de modèle.
• Ignorer le comportement de durée minimale ou de consommation minimale de jetons.
• Mesurer les clips générés au lieu des clips acceptés.
• Modifier en même temps le prompt, le modèle, la durée et la résolution pendant les tests.
• Traiter le text-to-video et le reference-to-video comme s’il s’agissait du même workflow.
• Oublier de suivre le temps de revue humaine et le nombre de réexécutions.
• Coder en dur un seul ID de modèle Seedance sans solution de repli ni parcours de revue.

La solution est simple : figez un jeu de test, exécutez des paramètres comparables, consignez la voie et les champs de coût, puis choisissez la voie en fonction de la sortie acceptée.

Plan de configuration recommandé

Pour une équipe qui démarre cette semaine, utilisez la séquence suivante :

1. Exécutez 20 prompts sur seedance-2.0-mini ou seedance-2.0-fast pour filtrer la structure des prompts.
2. Faites évoluer les meilleurs prompts vers seedance-2.0-pro et seedance-2.5.
3. Comparez le taux de clips acceptés, pas seulement les préférences visuelles.
4. Utilisez seedance-2.5 pour les clips fortement dépendants de références ou avec audio activé.
5. Utilisez une voie 2.0 moins coûteuse pour une exploration large lorsque le taux d’acceptation reste bon.
6. Conservez le même solde Flatkey et la même surface de reporting si votre workflow utilise aussi des modèles d’image, d’audio ou de texte.

Cela vous donne une configuration tarifaire pratique de l’API Seedance : un chemin d’endpoint, des choix de modèles visibles, une feuille de calcul des coûts et une grille de revue qui maintient la qualité liée aux dépenses.

FAQ

Qu’est-ce que l’API Seedance ?

L’API Seedance est une API de génération vidéo pour créer de courts clips à partir de prompts et, selon la voie choisie, de médias image ou de référence. Sur Flatkey, les pages de modèles Seedance exposent la voie vidéo via /v1/videos.

Comment le prix de l’API Seedance est-il calculé ?

Sur les pages publiques des modèles de Flatkey, les voies Seedance actuellement visibles sont présentées comme un prix par seconde, avec des options de résolution et de durée propres au modèle. La documentation de tarification de BytePlus ModelArk décrit la tarification de la génération vidéo par taux de jetons et consommation de jetons, avec une utilisation finale soumise aux champs d’utilisation retournés et à des règles de consommation minimale de jetons pour certaines requêtes Seedance.

Par quel modèle Seedance dois-je commencer ?

Commencez avec seedance-2.0-fast ou seedance-2.0-mini pour une exploration à faible coût, puis évaluez seedance-2.0-pro et seedance-2.5 sur les prompts qui passent la revue. Choisissez seedance-2.5 lorsque vous avez besoin de ses contrôles documentés de référence, d’audio et de workflow de 4 à 30 secondes.

Quel endpoint dois-je utiliser pour les requêtes de l’API Seedance sur Flatkey ?

Utilisez POST /v1/videos avec l’ID de modèle Seedance indiqué sur la page du modèle Flatkey. Les pages Seedance 2.5, 2.0 Pro, 2.0 Fast et 2.0 Mini affichent toutes /v1/videos comme route.

Que dois-je mesurer dans un test qualité de l’API Seedance ?

Mesurez le respect du prompt, la continuité du mouvement, la fidélité aux références, la sécurité de la marque, la modifiabilité, la latence, le nombre de tentatives et le coût par clip accepté. Le prix par seconde n’est qu’un paramètre parmi d’autres dans la décision.

Sources vérifiées

• Page du modèle Flatkey Seedance 2.5 : https://flatkey.ai/models/seedance-2.5
• Page du modèle Flatkey Seedance 2.0 Pro : https://flatkey.ai/models/seedance-2.0-pro
• Page du modèle Flatkey Seedance 2.0 Fast : https://flatkey.ai/models/seedance-2.0-fast
• Page du modèle Flatkey Seedance 2.0 Mini : https://flatkey.ai/models/seedance-2.0-mini
• Page de tarification de Flatkey : https://flatkey.ai/pricing
• Documentation de tarification BytePlus ModelArk : https://docs.byteplus.com/en/docs/modelark/model-pricing
• Documentation de l’API de tâche de génération vidéo de BytePlus ModelArk : https://docs.byteplus.com/en/docs/modelark/create-video-generation-task-api