HiAPI
Blog

Guide d'utilisation

Seedance 2.0@ext 短视频 : un workflow API pratique pour les formats courts sociaux

Avec l'API de tâches asynchrones seedance-2.0@ext, transformez un prompt détaillé en une vidéo verticale finalisée avec audio

Aug 10, 2026
Seedance 2.0@ext 短视频 : un workflow API pratique pour les formats courts sociaux

Aujourd'hui, la majeure partie de la découverte de contenu social se fait sur les vidéos courtes, et une courte vidéo verticale propre implique généralement de filmer, de monter, ou les deux. Sur hiapi, seedance-2.0@ext saute ces étapes : rédigez un prompt détaillé, appelez un point de terminaison API, et quelques minutes plus tard vous récupérez une vidéo 9:16 finalisée — audio inclus.

Ce guide pratique détaille de bout en bout le workflow complet à partir d'une vraie vidéo générée : comment le prompt est structuré, comment l'appel à l'API de tâches asynchrones fonctionne concrètement, combien cela a coûté, et où la tarification cesse de correspondre à vos attentes.

Pourquoi choisir seedance-2.0@ext pour les formats courts

seedance-2.0@ext est la route ext de la famille de modèles seedance-2.0 sur hiapi — une route distincte, avec sa propre tarification et son propre jeu de paramètres, différente de la route seedance-2.0 par défaut. Elle est conçue pour les sorties verticales natives des réseaux sociaux : cadrage natif 9:16, mouvements de caméra qui rendent bien sur écran de téléphone, et audio produit lors de la même génération que la vidéo, plutôt qu'ajouté après coup.

C'est cette combinaison — cadrage vertical plus audio natif — qui la rend adaptée aux formats courts de style TikTok et Reels, plutôt que de recourir à un modèle vidéo générique puis de recadrer et d'ajouter une musique soi-même après coup.

Le prompt : ce que cette vidéo a réellement utilisé

Nous avons généré pour cet article une vidéo de démonstration de bout en bout : un gros plan produit vertical d'un café infusé à froid versé dans un verre rempli de glaçons, dans un style destiné au fil d'actualité social. Voici la sortie réelle, ainsi que le prompt original qui l'a générée.

Gros plan produit vertical 9:16 pour fil d'actualité social : un verre en verre dépoli placé au centre sur un comptoir en marbre baigné de soleil. La caméra part d'un lent travelling avant en plongée au-dessus du verre vide, qui se remplit de glaçons transparents réfléchissant la lumière de l'heure dorée. À la deuxième seconde, un filet de café infusé à froid est versé depuis hors champ au-dessus, tourbillonne et assombrit les glaçons, puis le lait s'infiltre en fines volutes spiralées. Des gouttelettes glissent le long du verre, la froideur s'échappe vers le haut dans le contre-jour. La caméra passe lentement d'une plongée à un arc vers une vue trois-quarts en contre-plongée, pour se poser sur un gros plan net à faible profondeur de champ, avec un bokeh chaleureux à travers la fenêtre en arrière-plan. Éclairage commercial naturel et lumineux, reflets brillants, faible profondeur de champ, esthétique de vidéo produit ultra-propre, micro-mouvements fluides à la main, rendu commercial haut de gamme. Audio natif : léger filet de versement, glaçons qui tintent contre le verre, léger bruit de fond de café, sans musique. Aucun texte lisible, aucun logo, aucune personne, aucune main, aucun montage.

Résultat : 720×1280 (9:16), 24 fps, environ 8 secondes, avec un audio stéréo AAC natif intégré au fichier — sans pipeline de bruitage séparé.

Pourquoi ce prompt fonctionne

Ce prompt fait plusieurs choses que des prompts plus courts et plus vagues ne font pas :

  • Il donne un trajet à la caméra, pas une image unique. « travelling avant en plongée » → « lent arc vers une vue trois-quarts en contre-plongée » → « gros plan net » décrit un mouvement qui traverse toute la vidéo, et non une composition statique.
  • Il fixe le timing de l'action. « À la deuxième seconde, un filet de café infusé à froid est versé » ancre le versement à un instant précis, au lieu de laisser le modèle deviner quand doit se produire « la partie intéressante ».
  • Il superpose des indications de matière et de lumière. Gouttelettes, froideur, bokeh chaleureux, reflets brillants — ces détails font passer un plan produit de l'ordinaire au haut de gamme.
  • L'audio est écrit directement dans le prompt, et non ajouté après coup : filet de versement, tintement des glaçons, bruit de fond ambiant, et explicitement sans musique. Le modèle synchronise le son avec l'action visuelle décrite ci-dessus.
  • Il se termine par une liste négative. « Aucun texte lisible, aucun logo, aucune personne, aucune main, aucun montage » écarte d'emblée les modes d'échec les plus courants en génération de produits.

Traitez le prompt comme un bref créatif condensé, et non comme une simple légende — c'est là que se joue réellement la différence de qualité de sortie.

Reproduire avec l'API /v1/tasks

seedance-2.0@ext fonctionne via le point de terminaison de tâches asynchrones de hiapi. Vous soumettez une tâche, interrogez jusqu'à son achèvement, puis récupérez la vidéo dans la réponse.

Soumission :

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt et aspect_ratio sont obligatoires — si vous omettez aspect_ratio, l'appel échoue à la validation avant même d'atteindre la génération. resolution, duration (4 à 15 secondes) et generate_audio sont facultatifs ; les valeurs ci-dessus sont proches de la configuration utilisée pour générer la vidéo de cet article.

Si vous venez d'un raisonnement image-vers-vidéo, une remarque s'impose : la page de tarification indique des tarifs image-vers-vidéo pour ce modèle, mais le schéma d'entrée réel n'accepte que des prompts textuels — les champs image ou image de référence sont rejetés. Quel que soit le libellé de la tarification, il s'agit en pratique d'un modèle texte-vers-vidéo.

Interroger le résultat :

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Dès que status signale un succès, output[0].url pointe vers le fichier .mp4 finalisé. Ce lien est temporaire — environ une semaine selon la fenêtre d'expiration indiquée dans la réponse de la tâche — donc téléchargez immédiatement les octets et stockez-les vous-même, plutôt que de créer un lien direct vers lui.

Tarification : l'anomalie du 4K

seedance-2.0@ext est facturé à la seconde de sortie, avec un tarif qui varie selon le palier de résolution :

Résolution Prix par seconde
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

Notez que sur ce modèle, la 4K est moins chère que la 2K — $0.467/s contre $0.662/s. Ce n'est ni une faute de frappe ni un schéma courant ; la plupart des modèles ici voient leur prix augmenter de façon monotone avec la résolution. Ne supposez pas qu'il en va de même pour d'autres modèles, et revérifiez /api/pricing avant d'intégrer une logique de coût basée sur la résolution dans votre pipeline, car ces paliers sont bel et bien susceptibles d'être ajustés.

Pour référence, la vidéo de démonstration de 8 secondes en 720p ci-dessus a coûté $1.19 à générer — un simple calcul durée × tarif par seconde dans le palier 720p.

Choisir la résolution selon la destination réelle de la vidéo

Le seul passage de 720p à 1080p multiplie le coût par environ 2,5, donc avant de générer quoi que ce soit en série, la résolution est le levier à considérer en premier :

  • Diffusion dans les fils et Stories (TikTok, Reels, Shorts) se regarde presque toujours sur téléphone, avec une densité de pixels qui n'est qu'une fraction de la densité réelle de la 1080p — le 720p y est généralement indiscernable, et c'est le palier le moins cher.
  • Le 1080p vaut le coup lorsque la vidéo peut être réutilisée en visuel principal d'une page d'atterrissage, ou dans une campagne payante susceptible d'être rendue à une taille supérieure à l'écran d'un téléphone.
  • La 2K et la 4K conviennent à des sources que vous prévoyez de recadrer, zoomer ou stabiliser en post-production — la résolution supplémentaire vous donne de la marge pour recomposer sans perte visible de qualité. Vu la grille tarifaire ci-dessus, sur ce modèle précis, la 4K est l'option la plus intéressante des deux.

Questions fréquentes

seedance-2.0@ext prend-il en charge l'image-vers-vidéo, et pas seulement le texte-vers-vidéo ? Non — bien que la page de tarification indique des tarifs image-vers-vidéo pour ce modèle, le schéma réel de /v1/tasks de la route ext n'accepte que des prompts textuels ; les champs URL d'image, image de référence et vidéo de référence sont rejetés. Considérez-le comme texte-vers-vidéo uniquement, jusqu'à ce que la liste des modèles de la plateforme indique le contraire.

Puis-je contrôler la durée de la vidéo générée ? Oui, via le champ facultatif duration, avec un entier de 4 à 15 secondes. Si vous l'omettez, le modèle applique une valeur par défaut ; si un template en aval attend une longueur précise, il est plus sûr de la définir explicitement.

La vidéo inclut-elle automatiquement l'audio ? La génération audio native est disponible via le champ facultatif generate_audio. Écrivez directement dans le prompt l'audio que vous voulez — comme le « léger filet de versement, glaçons qui tintent contre le verre, léger bruit de fond de café » ci-dessus — pour qu'il soit synchronisé avec l'action visuelle, sans pipeline audio séparé.

La 4K est-elle vraiment moins chère que la 2K, ou est-ce un bug d'affichage ? C'est la tarification réelle en vigueur à la date de rédaction (août 2026), pas un bug — mais la tarification par résolution peut changer, donc avant de vous appuyer dessus dans un modèle de coûts, vérifiez sur /api/pricing.

Combien de temps l'URL vidéo renvoyée reste-t-elle valide ? L'output[0].url d'une tâche terminée est un lien temporaire, valable environ une semaine selon les métadonnées d'expiration de la tâche. Téléchargez et stockez le fichier vous-même, plutôt que de créer un lien durable vers lui.

Et ensuite

Les détails complets des paramètres et la tarification actuelle de ce modèle figurent sur la page du modèle seedance-2.0@ext et sur la page de tarification hiapi. Pour découvrir d'autres schémas de prompts autour du même modèle, Recettes de prompts Seedance 2.0@ext propose davantage d'exemples, tandis que Présentation produit en vidéo courte basée sur Seedance 2.0 explique comment appliquer le même workflow de tâches asynchrones à un brief créatif différent.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API