Wan3.0
Génération vidéo Wan3.0
- Modèle vidéo de référence tout-en-un Alibaba Cloud Wanxiang 3.0
- Texte-vers-vidéo / première image / première+dernière image / référence multimodale / référence fichier ou lien
- Résolution 480P / 720P / 1080P, durée 2–30 secondes
- Prend en charge images, vidéo, audio, documents et pages web publiques comme références
POST
Authentification
string
requis
Tous les endpoints exigent une authentification Bearer TokenObtenez votre API Key depuis la page de gestion des API Keys :
Modes de génération
Le nom du modèle est fixé àwan3.0-video. Les modes sont sélectionnés via les champs de la requête :
Paramètres de la requête
Bases
string
requis
Valeur fixe :
wan3.0-videostring
Description textuelle. Obligatoire sauf si des champs média sont fournis (au moins un parmi prompt ou média).
- Max 20 000 caractères ; le dépassement est tronqué automatiquement (sans erreur)
- En mode référence, utilisez « 图N / 视频N / 音频N » pour désigner les assets ; les indices suivent l’ordre au sein de chaque type de média
string
défaut:"1080P"
Résolution de sortie (insensible à la casse)
480P720P1080P(par défaut, prix le plus élevé)
string
défaut:"adaptive"
Rapport d’aspect.
aspect_ratio est également accepté.adaptive(par défaut)16:9/4:3/1:1/3:4/9:16
integer
défaut:"5"
Durée en secondes, 2–30, par défaut
5Avec une entrée vidéo de référence, la durée totale des vidéos d’entrée + la
duration de sortie doit être ≤ 30 secondes.boolean
défaut:"true"
Indique si la sortie inclut une piste audio. Par défaut
true. Le prix est le même avec ou sans audio.integer
Graine aléatoire dans
[0, 2147483647]boolean
défaut:"false"
Indique s’il faut ajouter un filigrane. Par défaut
falsestring
Comment les
image_urls brutes sont classées :frame— famille première/dernière imagereference— famille de référence
Entrées média
string[]
Tableau d’URL d’images. L’attribution des rôles suit les règles d’exclusion mutuelle.URL publique ou Base64 (
data:image/png;base64,...).object[]
Images avec rôles explicites. Chaque élément :
url: adresse de l’imagerole:first_frame/last_frame/reference_image(alias courants acceptés)
string[]
Vidéos de référence, jusqu’à 5 clips ; chacun 1–15 s, total ≤ 15 s
string[]
Audio de référence, jusqu’à 5 clips ; chacun 1–15 s, total ≤ 15 s
string
Audio de référence unique (forme monovaleur de
audio_urls)string
URL de document de référence, au plus 1. Ne peut pas être combiné avec
link_url.Formats : docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md, ≤100 Mo, ≤50 pages.string
URL de page web publique, au plus 1. Pages sans connexion uniquement. Ne peut pas être combiné avec
file_url.Exclusion mutuelle des familles de médias
Les médias appartiennent à l’une des deux familles et ne doivent pas être mélangés (validé avant soumission → 400, pas de tâche, pas de facturation) :Comment les image_urls brutes sont assignées
- Si
generation_typeest défini → l’utiliser (frame/reference) - Sinon, si la requête contient déjà des entrées de la famille de référence (
video_urls/audio_urls/audio_url/file_url/link_url) → traiter commereference_image - Sinon → famille frame : premier élément
first_frame, secondlast_frame(identique àwan2.7)
image_with_roles lorsque vous avez besoin d’un contrôle explicite.
Limites et formats des médias
Exemples de requête
Texte-vers-vidéo
Vidéo à partir de la première image
Première + dernière image
image_with_roles :
Référence multimodale
Avecvideo_urlsprésent, lesimage_urlsbrutes se classent automatiquement comme images de référence ; définirgeneration_type: "reference"est plus clair.
Vidéo de référence par fichier
prompt peut être omis ; la génération est pilotée par le document :
Vidéo de référence par page web
Facturation
Par seconde × résolution (aligné sur le tarif officiel). Audio activé/désactivé ne change pas le prix :- Par défaut 1080P (le plus cher) ; passez
480P/720Plorsque le coût est sensible - Secondes facturables =
durationdemandée audio: true/falsen’affecte pas le prix
Limites et notes
Erreurs courantes
Toutes sont des 400 synchrones (pas de tâche, pas de facturation) :Réponse
integer
Code de statut ; 200 en cas de succès
array
Tableau de données de réponse
Consulter les résultatsLa génération vidéo est asynchrone. Interrogez Obtenir le statut de la tâche ou
GET /v1/videos/generations/{task_id}.Intervalle recommandé 5–10 secondes ; la génération prend généralement 1–5 minutes. En cas de succès, utilisez les URL dans result.videos.