Vous avez lu l'annonce de Seedance 2.5, vous avez esquissé une fonctionnalité de produit autour de clips générés de 30 secondes, et maintenant vous voulez écrire du code. Puis vous vous heurtez au mur que chaque développeur rencontre avec un modèle fraîchement annoncé : la page de capacités est en ligne, mais le point de terminaison que vous pouvez réellement appeler depuis votre application est une toute autre question.
Voici la version honnête de la situation, et un démarrage rapide qui la respecte. Atlas Cloud a publié une page de famille Seedance 2.5 s'engageant à un accès Day-0 sur les mêmes points de terminaison unifiés qui servent déjà Seedance 2.0 et 1.5. Au moment de la rédaction, cette liste est marquée "Coming Soon" et aucun prix Atlas Cloud pour Seedance 2.5 n'a été publié. Ce que cela signifie concrètement est une bonne nouvelle : l'intégration que vous construisez aujourd'hui contre un niveau Seedance en direct est la même intégration que vous exécuterez au lancement de la 2.5. La seule chose qui change est la chaîne du modèle.
Ce démarrage rapide a donc deux objectifs. Il permet d'obtenir une vraie vidéo à partir d'un vrai point de terminaison aujourd'hui, et il structure votre code et vos invites de manière à ce que la mise à niveau soit une différence d'une seule ligne.
Ce qui est réellement livré dans Seedance 2.5
Selon la page officielle de Seedance 2.5 de ByteDance, il s'agit d'un modèle de génération conjointe audio-vidéo de nouvelle génération conçu pour la narration de 30 secondes avec un contrôle précis des références et une édition puissante. Les affirmations concrètes sur lesquelles il faut se baser pour la conception :
- Jusqu'à 30 secondes en une seule génération, avec la possibilité d'étendre deux fois pour une narration plus longue et plus complète
- Mouvement plus fluide et plus cohérent, avec des visuels plus réalistes
- Compréhension plus précise de la vidéo de référence, capturant l'intention, le cadrage et le langage cinématographique plutôt que de simplement transférer le mouvement
- Édition plus fiable sur une plus large gamme de demandes d'édition audio et visuelle
- Contrôle du modèle blanc et édition sur écran vert, ainsi que mouvement de caméra professionnel et blocage de performance, visant des flux de travail de production complexes
Notez ce qui ne figure pas sur cette liste : pas de tableau de référence, pas d'échelle de résolution, pas de nombre d'actifs de référence. Tout ce que vous avez vu dans ce sens est le vernis marketing de quelqu'un, pas la fiche technique du premier parti. Construisez sur les affirmations ci-dessus.
Étape 1 : obtenir une clé depuis la console
Connectez-vous sur console.atlascloud.ai et créez une clé API. Il n'y a pas de dépôt, pas d'engagement minimum et pas de liste d'attente, donc la clé est utilisable immédiatement en mode paiement à l'usage. Une clé couvre le catalogue complet de plus de 300 modèles de texte, d'image et de vidéo, sur un seul compte de facturation, ce qui est la partie importante pour ce démarrage rapide : la clé que vous créez maintenant est la même clé qui appellera Seedance 2.5.
Stockez-la comme variable d'environnement, jamais dans le code source. ATLASCLOUD_API_KEY est un bon nom.
Étape 2 : soumettre un travail vidéo
La génération vidéo sur Atlas Cloud est un appel REST asynchrone en deux étapes, et non une complétion de chat. Vous POSTez un travail et obtenez un ID de prédiction, puis vous interrogez cet ID jusqu'à ce que le rendu soit terminé. N'importe quel client HTTP fera l'affaire, il n'y a donc pas de SDK fournisseur à installer et pas de nouveau schéma d'authentification à apprendre : c'est un jeton de porteur sur la clé que vous venez de créer.
python1import os, time, requests 2 3KEY = os.environ["ATLASCLOUD_API_KEY"] 4BASE = "https://api.atlascloud.ai/api/v1/model" 5HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"} 6 7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={ 8 "model": "bytedance/seedance-2.0/text-to-video", 9 "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, " 10 "neon reflections on wet asphalt, slight lag on turns.", 11 "duration": 5, 12 "resolution": "720p", 13 "ratio": "adaptive", 14 "bitrate_mode": "standard", 15 "generate_audio": True, 16 "watermark": False, 17}).json() 18 19prediction_id = job["data"]["id"]
La réponse est {"code": 200, "data": {"id": "...", "status": "processing"}}. Notez que model est un champ de chaîne de caractères simple. Ce détail est toute l'histoire de la mise à niveau pour cet article, et l'étape 6 y revient.
Étape 3 : interroger jusqu'à ce que le rendu soit terminé
Un clip de 5 secondes n'est pas une réponse instantanée, alors traitez le rendu comme un travail avec un cycle de vie plutôt que comme un appel bloquant. Interrogez le point de terminaison de prédiction jusqu'à ce que le status atteigne une valeur terminale.
python1while True: 2 r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json() 3 status = r["data"]["status"] 4 if status in ("completed", "succeeded", "failed"): 5 break 6 time.sleep(3) 7 8print(status, r["data"]) # on success the payload carries the output URL(s)
Deux choses à intégrer maintenant plutôt que plus tard. Fixez un plafond à la boucle d'interrogation afin qu'un travail bloqué ne puisse pas bloquer un gestionnaire de requêtes, et persistez l'ID de prédiction avant de commencer l'interrogation afin qu'un travailleur en panne puisse reprendre au lieu de payer deux fois pour le rendu. Ces deux habitudes se transmettent inchangées à la version 2.5.
Si votre fonctionnalité fonctionne à partir d'une image de référence ou d'une référence de sujet au lieu de texte pur, le même flux s'applique avec une variante de modèle différente, bytedance/seedance-2.0/image-to-video ou bytedance/seedance-2.0/reference-to-video. Les actifs de référence de sujet sont téléchargés une fois via uploadMedia puis passés comme asset://<id> dans les champs d'image, de sorte qu'un personnage ou un produit récurrent n'a pas besoin d'être re-téléchargé à chaque appel.
Étape 4 : choisissez un niveau Seedance en direct et sachez ce que coûte une seconde
Atlas Cloud facture la vidéo par seconde de durée de sortie. C'est une arithmétique que vous pouvez faire dans votre tête avant d'écrire du code. Trois niveaux Seedance sont en direct aujourd'hui :
| Modèle | ID du modèle | Prix Atlas Cloud | Remarquable |
|---|---|---|---|
| Seedance 2.0 | bytedance/seedance-2.0/text-to-video | 0,112 $/s | Niveau phare en direct, clé instantanée, pas de liste d'attente |
| Seedance 2.0 Fast | bytedance/seedance-2.0-fast/text-to-video | 0,09 $/s | Variante plus rapide de la même famille |
| Seedance 2.0 Mini | bytedance/seedance-2.0-mini/text-to-video | 0,056 $/s | Niveau Seedance 2.0 en direct le moins cher, également image-to-video et reference-to-video |
| Seedance 1.5 Pro | bytedance/seedance-v1.5-pro/text-to-video | 0,047 $/s, ou 0,018 $/s sur la variante Fast | Audio synchronisé natif, synchronisation labiale multilingue, clips de 4 à 12 secondes |
Pour vous orienter, d'autres modèles vidéo sur la même clé fonctionnent dans une fourchette comparable : Grok Imagine Video v1.5 à 0,080 $/s, Wan 2.7 à 0,100 $/s, Kling V3.0 Turbo à 0,112 $ standard et 0,095 $ réduit, MiniMax H3 à 0,14 $/s.
Le choix du modèle sur lequel construire dépendra de ce que votre fonctionnalité 2.5 fera finalement. Si l'audio est central à la sortie, Seedance 1.5 Pro est le niveau qui dispose déjà d'un audio synchronisé natif et d'une synchronisation labiale multilingue, de sorte que votre pipeline apprend à gérer une piste audio dès le premier jour. Si vous itérez sur la structure des invites et souhaitez le coût le plus bas par expérience, Seedance 2.0 Mini à 0,056 $/s est le bac à sable évident. Si vous voulez ce qui se rapproche le plus d'un rendu de génération actuelle de qualité production, Seedance 2.0 à 0,112 $/s est le choix simple, avec la variante Fast à 0,09 $/s si le débit est plus important que le dernier incrément de qualité.
Étape 5 : vérifiez le prix en direct dans le Playground avant de dépenser
Avant votre premier appel payant, ouvrez le modèle dans l'Atlas Cloud Playground. Chaque modèle affiche son prix en direct par modèle à côté du bouton Exécuter. Cela est plus important qu'il n'y paraît : les remises promotionnelles vont et viennent, et le chiffre à côté du bouton Exécuter est celui qui sera réellement facturé. Exécutez une génération dans le Playground, confirmez que la sortie correspond aux besoins de votre fonctionnalité, puis portez les paramètres dans le code.
Le modèle de facturation par seconde de sortie rend également votre conversation budgétaire triviale. Un clip de 10 secondes sur Seedance 2.0 Mini coûte 10 × 0,056 $. Il n'y a pas de calculatrice, pas d'estimation de jetons et pas d'étape de réconciliation a posteriori.
Cela contraste avec la façon dont les canaux ByteDance de première partie facturent Seedance. Sur Volcano Engine Ark en Chine et BytePlus ModelArk à l'international, la facturation est basée sur les jetons : la consommation estimée de jetons est (durée de la vidéo d'entrée + durée de la vidéo de sortie) × largeur de sortie × hauteur de sortie × fréquence d'images de sortie / 1024, multipliée par un prix unitaire de jeton, l'utilisation réelle étant déterminante à partir du champ usage.completion_tokens dans la réponse de l'API. Pour la série Seedance 2.0 et Seedance 2.5, lorsque l'entrée inclut de la vidéo, un plancher de consommation minimale de jetons s'applique, et ce plancher dépend de la résolution, du rapport d'aspect et de la durée de sortie. ByteDance publie un calculateur de prix ainsi qu'un tableau de jetons minimum pour cette raison exacte.
Les deux modèles sont légitimes. Mais si vous budgétisez un rendu de 30 secondes, la durée par seconde de sortie est un calcul mental et les jetons avec planchers nécessitent une feuille de calcul.
Étape 6 : rédigez la description de la prise de vue comme si c'était déjà la 2.5
C'est la partie du démarrage rapide qui se transfère parfaitement, car l'art de l'invite n'est pas versionné. Deux des affirmations de capacité de la 2.5 devraient changer la façon dont vous écrivez aujourd'hui.
Contrôle précis des références. ByteDance affirme que la 2.5 lit une vidéo de référence pour son intention, son cadrage et son langage cinématographique, allant au-delà du transfert de mouvement. L'implication pour l'invite est que votre actif de référence cesse d'être un modèle de mouvement et commence à être un bref directorial. Alors, arrêtez d'écrire des invites qui ne décrivent que le sujet, et commencez à nommer la grammaire que vous voulez transférer : la sensation de l'objectif, le cadrage, le rythme de la coupe, si la caméra mène ou suit le sujet. Écrivez "plan moyen à main levée, suivant le sujet, d'un coursier traversant un marché de nuit, reflets néon sur l'asphalte mouillé, léger décalage dans les virages" au lieu de "personne marchant, cinématographique".
Trente secondes en une seule génération. Un clip de 5 secondes est une seule prise de vue. Trente secondes, c'est une scène avec une structure, et la 2.5 prend en charge l'extension deux fois en plus de cela. Alors, écrivez des descriptions de prises de vue avec une structure rythmique plutôt qu'une seule description statique : un rythme d'établissement, un changement (un virage, une entrée, une révélation) et une résolution. Nommez explicitement le mouvement de la caméra et le blocage de la performance, car ce sont exactement les contrôles que la 2.5 vise. Où le sujet se tient, où il se déplace, ce que fait la caméra pendant qu'il se déplace.
Ces deux habitudes sont payantes sur les niveaux en direct maintenant. Ce sont exactement les habitudes que la 2.5 récompense.
Étape 7 : planifier l'échange
Structurez votre code de manière à ce que l'identifiant du modèle soit une configuration, et non un littéral. Une constante, lue à partir de l'environnement ou de la configuration :
python1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
Ensuite, passez SEEDANCE_MODEL là où l'étape 2 avait codé en dur la chaîne. Parce que model est un champ de chaîne JSON unique dans le corps de generateVideo, la mise à niveau au lancement de la 2.5 est vraiment une variable d'environnement. Pas une métaphore pour un petit changement, littéralement une seule valeur.
Ne codez jamais en dur un identifiant Seedance 2.5 aujourd'hui, car aucun ID de modèle Atlas Cloud Seedance 2.5 n'existe encore. Tirez les ID en direct exacts du catalogue sur atlascloud.ai/models plutôt que de les copier d'un article, y compris celui-ci, car de nouvelles variantes sont ajoutées au fil du temps. Lorsque la 2.5 sera disponible dans le cadre de l'engagement Day-0, le travail de votre côté sera cette seule variable, plus un nouveau regard sur le prix à côté du bouton Exécuter et une relecture de tous les nouveaux paramètres de requête, car un modèle de 30 secondes avec prise en charge de l'extension acceptera probablement des champs que le corps de la 2.0 n'a pas.
En attendant, si vous avez besoin de Seedance 2.5 aujourd'hui plutôt qu'au lancement d'Atlas Cloud, la réponse honnête est les canaux ByteDance de première partie : Volcano Engine Ark en Chine et BytePlus ModelArk à l'international. Parmi les agrégateurs, plusieurs sont dans le même état de pré-lancement ou d'engagement Day-0.
FAQ
Q : Puis-je appeler Seedance 2.5 sur Atlas Cloud dès maintenant ? R : Non. La page de la famille Seedance 2.5 sur Atlas Cloud est marquée "Coming Soon" avec un engagement d'accès Day-0 sur les mêmes points de terminaison unifiés qui servent déjà Seedance 2.0 et 1.5. Aucun ID de modèle et aucun prix n'ont encore été publiés pour celle-ci.
Q : Combien coûte Seedance sur Atlas Cloud aujourd'hui ? R : Seedance 2.0 coûte 0,112 $/s, Seedance 2.0 Fast coûte 0,09 $/s, Seedance 2.0 Mini coûte 0,056 $/s, et Seedance 1.5 Pro coûte 0,047 $/s ou 0,018 $/s sur sa variante Fast. La facturation est par seconde de durée de sortie, et le prix en direct est affiché à côté du bouton Exécuter dans le Playground.
Q : Ai-je besoin d'un SDK spécial pour la vidéo sur Atlas Cloud ?
R : Non. La vidéo est un flux REST simple : POST /api/v1/model/generateVideo pour soumettre un travail, puis GET /api/v1/model/prediction/{id} pour l'interroger, les deux étant authentifiés avec un jeton de porteur sur votre clé Atlas Cloud. N'importe quel client HTTP fonctionne. Notez que la vidéo ne passe pas par le point de terminaison de chat compatible OpenAI que le catalogue de texte utilise, donc ne vous attendez pas à ce que chat.completions rende un clip. Les paramètres de requête par modèle sont documentés sur atlascloud.ai/docs.
Q : Y a-t-il un dépôt ou un engagement minimum pour commencer ? R : Non. Atlas Cloud est un service de paiement à l'usage sans dépôt, sans engagement minimum et sans liste d'attente, et la clé de console.atlascloud.ai est utilisable immédiatement.
Q : Sur quel niveau en direct dois-je prototyper si je cible la 2.5 ? R : Seedance 2.0 Mini à 0,056 $/s pour une itération d'invite bon marché, Seedance 1.5 Pro si votre pipeline doit gérer une piste audio synchronisée native, et Seedance 2.0 à 0,112 $/s pour le rendu de production de génération actuelle le plus proche.
En résumé
Atlas Cloud exécute Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini et Seedance 1.5 Pro aujourd'hui sur une seule clé API avec une facturation par seconde sur la durée de sortie, la certification SOC II, la conformité HIPAA et le chiffrement au repos et en transit, et il a publié un engagement Day-0 pour servir Seedance 2.5 sur ces mêmes points de terminaison unifiés lorsqu'il sera livré.
