Alibaba

Wan 3.0 Video

wan3.0-video

Nouvelle génération de modèles de génération vidéo de la série Wan d'Alibaba, capable de produire en une seule fois des clips d'environ 30 secondes en 1080p, prenant en charge des matériaux de référence pour préserver la cohérence du sujet et, pour la première fois, les entrées structurées de type document.

wan3.0-video wan3.0-video-prime

Essayer wan3.0-video

Entrée

Audio

Créations

Voir toutes les créations

Sortie

video

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

Tarifs

wan3.0-video per second

Spécifications	Prix unitaire
480P	$0.040
720P	$0.080
1080P	$0.160

Présentation

wan3.0-video est un modèle de la série Alibaba Wan dédié à la génération vidéo à partir de références, accessible via l'interface unifiée de HiAPI.ai. Conditionné par des éléments de référence multimodaux, il produit en un seul appel une vidéo avec son d'une durée maximale de 30 secondes et d'une résolution allant jusqu'à 1080P, adapté à la création de courts publicitaires, de vidéos explicatives et de séquences narratives longues nécessitant de conserver la cohérence d'un personnage, d'un produit ou d'un style sur toute la suite de plans.

Points clés

Combinaison de conditions de référence multimodales — jusqu'à 10 images, 5 vidéos et 5 audios peuvent servir simultanément de conditions de génération ; le prompt référence les éléments selon leur ordre dans le tableau.
Narration jusqu'à 30 secondes en une seule génération — la durée de sortie est réglable entre 2 et 30 secondes ; la durée de la vidéo de référence et celle de la sortie ne doivent pas dépasser 30 secondes au total.
Entrées document structuré et page web — accepte au plus un document ou une page web sans connexion comme référence, pour transformer des supports comme des PPT ou des PDF en contenu vidéo.
Contrôle des images de début et de fin, activation de la piste audio — l'image de première et de dernière frame peuvent être spécifiées séparément, et l'inclusion ou non d'une piste audio synchronisée avec l'image dans la sortie est au choix.

Description des capacités

Génération à partir de références multimodales : génère une vidéo à partir d'images, de vidéos, d'audios, de documents ou de pages web comme conditions de référence ; le prompt cible précisément un élément donné via des indices comme Image1, Video1, ce qui facilite le contrôle de la source du sujet et du style.

Contrainte des images de début et de fin : en fournissant first_frame_url et last_frame_url, on ancre l'image de début et de fin du segment, ce qui convient pour raccorder des plans existants ou contrôler le point de chute d'une transition.

Durée et résolution réglables : durée de sortie de 2 à 30 secondes, résolution de 480P à 1080P au choix, avec six formats d'image dont adaptive et 16:9, pour adapter le cadrage au canal de diffusion.

Sortie avec piste audio synchronisée : par défaut, la vidéo produite comporte une piste audio synchronisée ; il est aussi possible de la désactiver pour une post-synchronisation unifiée. Les références audio doivent être associées à une image ou à une vidéo.

Génération reproductible : spécifier seed permet de fixer la graine aléatoire, afin de reproduire le même résultat lors du réglage des paramètres ou de générations par lots.

Cas d'usage

Équipes de marque et de e-commerce : transformer des visuels produit en publicité — générer un court métrage au rendu cinématographique à partir d'images produit et d'une vidéo de référence, et produire des vidéos directement utilisables comme support publicitaire ou sur une fiche produit.
Équipes de contenu : narration avec cohérence du personnage — téléverser une image de référence du personnage et un audio pour générer une suite de plans conservant l'apparence du personnage, destinée à la production de mini-séries ou de contenus sériels.
Formation et présentation : transformer des documents en vidéo — utiliser un PPT, un PDF ou une page web sans connexion comme référence pour produire une vidéo explicative destinée à la formation interne ou à la présentation d'un produit.
Prolongement et complément de plans existants — générer un segment de raccord à partir d'une vidéo de référence et d'images de début et de fin, pour combler une lacune narrative ou allonger la durée de séquences déjà tournées.

Limites et conseils de choix

Les références ont des limites explicites : au maximum 10 images, 5 vidéos totalisant au plus 15 secondes, 5 audios de 1 à 15 secondes chacun, un document et une page web au plus ; le mode image de première frame n'est pas compatible avec le tableau de références. La qualité de description du sujet, de l'action, du cadrage et du son dans le prompt influence directement la stabilité du résultat, et un temps de mise au point doit être prévu. La facturation se fait à la seconde de sortie ; le coût d'une combinaison longue durée et haute résolution doit être évalué au préalable. Si seul un court extrait est nécessaire et que la cohérence des références n'est pas requise, un modèle vidéo plus léger peut être choisi.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Le modèle de génération vidéo wan3.0-video-prime est en ligne Nov 3, 2026

Questions fréquentes

Voir toutes les questions →

Quel type de modèle vidéo est Wan 3.0 Video ?

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 selon le contrat de paramètres actuel.
Quelles spécifications de sortie Wan 3.0 Video prend-il en charge ?

Prise en charge de 2 à 30 secondes, avec des résolutions incluant 480P, 720P et 1080P, et des formats d'image incluant adaptive, 16:9, 4:3, 1:1, 3:4 et 9:16.
Peut-on générer du son ou utiliser des références audio ?

Références optionnelles : images, vidéos, audios, fichiers et liens ; audio synchronisé pris en charge
Comment Wan 3.0 Video est-il facturé ?

La facturation est basée sur la durée de sortie et le palier 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 : wan3.0-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour wan3.0-video et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire permettant de reproduire une génération existante ; transmettez un entier fixe pour obtenir une sortie déterministe.

audiobooleanOptionnelDéfaut: true

Indique s'il faut générer en même temps que la vidéo de sortie une piste audio synchronisée avec l'image ; valeur booléenne, par défaut true.

promptstringRequisminLength 1maxLength 20000

Invite textuelle décrivant la scène, le mouvement, la caméra, l'éclairage et le son ; en mode référence, les éléments sont désignés par Image1, Video1, Audio1 dans l'ordre du tableau.

durationintegerOptionnelDéfaut: 5min 2max 30

Durée de la vidéo de sortie, en secondes, par défaut 5 ; la somme de la durée de la vidéo de référence et de la durée de sortie ne doit pas dépasser 30 secondes.

resolutionstringOptionnelDéfaut: "1080P"

Résolution de sortie, chaîne de caractères, par défaut 1080P.

Options：480P720P1080P

aspect_ratiostringOptionnelDéfaut: "adaptive"

Rapport largeur-hauteur de l'image de sortie, chaîne de caractères, par défaut adaptive, c'est-à-dire une adaptation automatique aux médias d'entrée et à l'invite.

Options：adaptive16:94:31:13:49:16

last_frame_urlstringOptionnel

Une image accessible publiquement, utilisée avec first_frame_url pour spécifier la dernière image de la vidéo.

first_frame_urlstringOptionnel

Une image accessible publiquement, utilisée comme première image de la vidéo ; ne peut pas être utilisée en même temps que le tableau de médias de référence.

reference_file_urlsarrayOptionnelmaxItems 1

Tableau d'URL de documents ou de présentations de référence, 1 au maximum, et devant être accessibles publiquement.

Array [ string ]

reference_link_urlsarrayOptionnelmaxItems 1

Tableau d'URL de pages web de référence, 1 au maximum, et ces pages doivent être accessibles publiquement, sans connexion requise.

Array [ string ]

reference_audio_urlsarrayOptionnelmaxItems 5

Tableau d'URL d'audios de référence, 5 fichiers WAV ou MP3 au maximum, chacun de 1 à 15 secondes ; les audios doivent être utilisés avec des images ou des vidéos.

Array [ string ]

reference_image_urlsarrayOptionnelmaxItems 10

Tableau d'URL d'images de référence, 10 au maximum, utilisé pour une génération de référence générale.

Array [ string ]

reference_video_urlsarrayOptionnelmaxItems 5

Tableau d'URL de vidéos de référence, 5 au maximum, chacune de 1 à 15 secondes, et la durée totale ne doit pas dépasser 15 secondes.

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": "wan3.0-video",
  "input": {
    "audio": true,
    "prompt": "…",
    "duration": 5,
    "resolution": "1080P",
    "aspect_ratio": "adaptive"
  }
}'

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: "wan3.0-video",
    input: {
      "audio": true,
      "prompt": "…",
      "duration": 5,
      "resolution": "1080P",
      "aspect_ratio": "adaptive"
    }
  }),
});
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": "wan3.0-video",
        "input": {
          "audio": True,
          "prompt": "…",
          "duration": 5,
          "resolution": "1080P",
          "aspect_ratio": "adaptive"
        }
    },
)
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"
    }
  }
}