ByteDance

Seedance 2.0

seedance-2.0-mini

Modèle de génération vidéo multimodale de ByteDance, prenant en charge la génération de vidéos à partir de texte, d'images et de références, et capable de produire des courts métrages cinématographiques multi-plans avec un audio natif synchronisé

Route

default ext

seedance-2.0 seedance-2.0-fast seedance-2.0-mini

Essayer seedance-2.0-mini

Entrée

Créations

Voir toutes les créations

Sortie

video

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

seedance-2.0-mini per second

Spécifications	480P	720P
Without Reference Videos	$0.0272	$0.0586
With Reference Videos	$0.0172	$0.0358

Positionnement

Seedance 2.0 Mini est la déclinaison légère de la famille Seedance 2.0 de ByteDance, accessible via l'interface unifiée de HiAPI.ai, avec prise en charge de la génération de vidéo à partir de texte, d'image et de matériaux de référence. Il accepte jusqu'à 9 images de référence, 3 vidéos de référence et 3 pistes audio de référence, en utilisant l'image, le mouvement et le timbre comme conditions de génération pour produire de courtes vidéos avec audio de 4 à 15 secondes en 480p ou 720p. Il convient aux développeurs qui doivent produire en série, sur des cycles courts, des contenus pour les réseaux sociaux, des prévisualisations publicitaires et des échantillons créatifs.

Points clés

Trois entrées de condition : image, vidéo et audio de référence — les matériaux de référence peuvent simultanément contraindre le style visuel, le mode de mouvement et l'audio, réduisant l'incertitude des descriptions purement textuelles.
Contrôle du début et de la fin du plan par les première et dernière images — en fournissant à la fois une image de première image et une image de dernière image, il est possible de spécifier où commence et où se termine le plan, ce qui facilite l'enchaînement de plusieurs plans.
Génération audio native optionnelle — l'audio synchronisé avec l'image est généré par défaut, mais le canal audio peut être désactivé pour ne produire que selon les besoins visuels.
Durée et format paramétrables — durée réglable de 4 à 15 secondes, prise en charge des formats 1:1, 16:9, 9:16, 21:9, etc., adaptés à la diffusion en paysage comme en portrait.

Description des capacités

Trois modes de génération : une invite textuelle, une image de première image ou des matériaux de référence peuvent tous servir de point de départ ; choisissez le mode de génération selon les éléments dont vous disposez, sans changer d'interface selon le mode.

Les matériaux de référence contraignent l'image et le mouvement : jusqu'à 9 images de référence (première et dernière images incluses), jusqu'à 3 vidéos de référence pour une durée totale n'excédant pas 15 secondes ; des matériaux réels remplacent de longues descriptions textuelles pour verrouiller le style et les actions.

L'audio de référence guide le timbre : jusqu'à 3 pistes audio de référence, d'une durée totale n'excédant pas 15 secondes, permettent au résultat généré de se rapprocher de l'échantillon fourni en termes de timbre et d'ambiance sonore.

Résolution et piste audio par paliers : le 480p génère plus vite, le 720p concilie vitesse et qualité ; la génération ou non de l'audio et la résolution déterminent ensemble le palier de facturation, à combiner selon le budget.

Cas d'usage

Production en série de vidéos courtes pour les réseaux sociaux — les équipes d'exploitation génèrent des clips verticaux 9:16 à partir d'invites courtes ou d'images de produits, directement diffusés dans les fils d'actualité et sur les comptes de vidéos courtes.
Prévisualisation de storyboards publicitaires — les équipes créatives produisent des extraits de prévisualisation de 4 à 15 secondes à partir d'images de référence et de première et dernière images, afin d'aligner le rythme des plans et la tonalité visuelle avant le tournage officiel.
Déclinaison stylistique de matériaux de marque — les designers téléversent des images de référence de marque et de courtes vidéos de référence pour générer une série de clips au style cohérent, destinés aux pages d'atterrissage et aux emplacements de présentation.
Prototypage rapide de courts métrages avec effets sonores — les créateurs de contenu activent la génération audio et l'associent à un audio de référence pour produire des échantillons synchronisés image-son, destinés à la validation et au montage secondaire.

Limites et conseils de sélection

La durée maximale d'une sortie unique est de 15 secondes, et la facturation se fait au nombre de secondes produites ; les contenus longs doivent être générés en plusieurs segments puis assemblés. La première image et les matériaux de référence sont des scénarios mutuellement exclusifs et ne peuvent pas être combinés dans une même requête ; les matériaux de référence sont soumis à des contraintes de nombre et de durée totale, et les projets comportant de nombreux éléments doivent être traités par lots. La résolution n'est prise en charge qu'en 480p et 720p ; pour les scénarios exigeant des rendus à haute résolution, il convient de se tourner vers une déclinaison de gamme supérieure au sein de la famille.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Le modèle de génération vidéo seedance-2.0-fast est disponible Nov 3, 2026
Nouveau modèle Nouveau modèle disponible : seedance-2.0-mini Nov 3, 2026
Changement de route La ligne ext de seedance-2.0 n'affiche désormais que les résolutions réellement prises en charge : 720p, 1080p… Aug 10, 2026

Questions fréquentes

Voir toutes les questions →

Seedance 2.0 est quel type de modèle vidéo ?

Il est centré sur le Prompt, et peut également intégrer des images de première et dernière frame ou des images, vidéos et audios de référence ; les différents modes de contrôle doivent être combinés conformément au contrat de paramètres actuel.
Quelles spécifications de sortie Seedance 2.0 prend-il en charge ?

Prise en charge de 4 à 15 secondes, résolutions incluant 480p, 720p, 1080p, 4k, formats d'image incluant 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive.
Peut-on générer de l'audio ou utiliser une référence audio ?

Références image, vidéo et audio en option ; génération audio prise en charge
Comment Seedance 2.0 est-il facturé ?

La facturation est basée sur la durée de sortie et le niveau en temps réel ; les différences dues à la résolution, au mode ou aux options audio sont déterminées par le prix affiché sur la page et l'historique des tâches.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : seedance-2.0-mini

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour seedance-2.0-mini et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 3maxLength 20000

Prompt textuel utilisé pour la génération vidéo, décrivant le contenu visuel souhaité, sous forme de chaîne de caractères.

durationintegerRequisDéfaut: 5min 4max 15

Durée de la vidéo en secondes, exprimée en nombre entier, plage de 4 à 15 ; facturation à la seconde, plus la durée est longue plus le coût est élevé. Valeur par défaut : 5 secondes.

resolutionstringRequisDéfaut: "720p"

Résolution de la vidéo de sortie, 720p par défaut ; la 480p génère plus rapidement, la 720p concilie vitesse et qualité d'image ; la résolution et la présence ou non d'audio correspondent à différents paliers de facturation.

Options：480p720p

aspect_ratiostringOptionnelDéfaut: "16:9"

Format d'image de la vidéo, spécifié sous forme de chaîne de caractères pour définir le rapport largeur/hauteur de la vidéo de sortie. Valeur par défaut : 16:9.

Options：1:14:33:416:99:1621:9adaptive

generate_audiobooleanOptionnelDéfaut: true

Indique s'il faut générer un audio natif synchronisé avec l'image, sous forme de valeur booléenne. Valeur par défaut : true.

last_frame_urlstringOptionnel

URL de l'image de dernière frame, utilisée conjointement avec la première frame. Exigences d'image identiques à la première frame : formats jpeg/png/webp/bmp/tiff/gif, rapport largeur/hauteur 0.4–2.5, côté 300–6000 px, chaque image inférieure à 30 Mo.

first_frame_urlstringOptionnel

URL de l'image de première frame ; si fournie, le traitement se fait en génération vidéo à partir d'une image. Formats pris en charge : jpeg/png/webp/bmp/tiff/gif, rapport largeur/hauteur 0.4–2.5, côtés 300–6000 px, chaque image inférieure à 30 Mo ; scénario mutuellement exclusif avec les images de référence et les vidéos de référence, utilisation combinée impossible.

reference_audio_urlsarrayOptionnelmaxItems 3

Liste d'URL d'audios de référence, au maximum 3 segments et une durée totale n'excédant pas 15 secondes ; chaque segment au format wav/mp3, durée de 2 à 15 secondes, inférieur à 15 Mo.

Array [ string ]

reference_image_urlsarrayOptionnelmaxItems 9

Liste d'URL d'images de référence ; le nombre d'images de la liste plus le nombre d'images de première et dernière frame ne doit pas dépasser 9 ; chaque image au format jpeg/png/webp/bmp/tiff/gif, rapport largeur/hauteur 0.4–2.5, côté 300–6000 px, chaque image inférieure à 30 Mo. Scénario mutuellement exclusif avec la première frame et les vidéos de référence, utilisation combinée impossible.

Array [ string ]

reference_video_urlsarrayOptionnelmaxItems 3

Liste d'URL de vidéos de référence, au maximum 3 et une durée totale n'excédant pas 15 secondes ; chaque vidéo au format mp4/mov, résolution 480p/720p, durée de 2 à 15 secondes, rapport largeur/hauteur 0.4–2.5, côté 300–6000 px, nombre total de pixels 409600–927408, fréquence d'images 24–60, chaque vidéo inférieure à 50 Mo.

Array [ string ]

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
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-mini",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0-mini",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.0-mini",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}