Le modèle de génération vidéo Wan produit des vidéos fluides à partir d' invites textuelles .
Références : Guide utilisateur
La région du modèle, l'URL de l'endpoint et la clé API doivent correspondre. Les appels interrégionaux échouent systématiquement.
Les tâches de génération vidéo à partir de texte nécessitent entre 1 et 5 minutes. L'API fonctionne de manière asynchrone : Créez une tâche → Interrogez régulièrement pour obtenir le résultat.
Remplacez
Remplacez
Les tâches de génération vidéo à partir de texte nécessitent entre 1 et 5 minutes. L'API fonctionne donc de manière asynchrone : Créer une tâche → Interroger le résultat.
Remplacez
Remplacez
Les noms de paramètres du SDK correspondent en grande partie à ceux de l'API HTTP, tandis que les structures suivent les conventions spécifiques à chaque langage.
Les tâches de conversion texte-en-vidéo prennent entre 1 et 5 minutes. Le SDK encapsule le flux d'appels HTTP asynchrones et prend en charge l'invocation synchrone et asynchrone.
Définissez region selon la région du modèle (elle est passée lors de la construction du Client ; la valeur de region varie selon la région) :
Remplacez
Définissez Constants.baseHttpApiUrl sur l'endpoint de la région :
Remplacez
Si l'appel au modèle échoue et renvoie un message d'erreur, reportez-vous à la rubrique Codes d'erreur pour obtenir des instructions de résolution.
R : Deux changements s'imposent :
R : La conversion directe est impossible. Téléchargez la vidéo depuis l'URL fournie, puis importez-la vers un stockage persistant (tel qu'Alibaba Cloud OSS) afin de générer un lien permanent.
R : Non. Ce lien expire au bout de 24 heures. Téléchargez la vidéo, conservez-la dans un stockage persistant, puis utilisez un lien permanent pour la lecture.
Disponibilité
La région du modèle, l'URL de l'endpoint et la clé API doivent correspondre. Les appels interrégionaux échouent systématiquement.
- Sélectionner un modèle : Vérifiez la disponibilité du modèle dans votre région cible.
- Choisir une URL : Utilisez l'URL d'endpoint correspondant à la région concernée. Les protocoles HTTP et HTTPS sont tous deux pris en charge.
- Configurer une clé API : Sélectionnez une région, obtenez une clé API, puis configurez-la dans les variables d'environnement.
- Installer le SDK : Pour appeler l'API via un SDK, installez le SDK DashScope.
Les exemples de code de cette rubrique utilisent la région Singapour.
Instructions
HTTP (wan2.7)
Les tâches de génération vidéo à partir de texte nécessitent entre 1 et 5 minutes. L'API fonctionne de manière asynchrone : Créez une tâche → Interrogez régulièrement pour obtenir le résultat.
Étape 1 : Créer une tâche
- Beijing
- Singapore
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} par votre véritable ID d'espace de travail.
- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Ne créez pas de tâches en double. Privilégiez l'interrogation régulière pour récupérer le résultat. - Pour un guide destiné aux débutants, consultez Appeler des API avec Postman ou cURL.
Paramètres de requête |
Contrôlez la structure des plans en langage naturel dans le prompt. Le paramètre shot_type n'a aucun effet.
| ||||||||||||||||||||||||
En-têtes | |||||||||||||||||||||||||
Content-Type string (Required)Type de contenu de la requête. Doit être application/json. | |||||||||||||||||||||||||
Authorization string (Required)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |||||||||||||||||||||||||
X-DashScope-Async string (Required)Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable. | |||||||||||||||||||||||||
Corps de la requête | |||||||||||||||||||||||||
model string (Required)Nom du modèle. Pour la liste des modèles et les tarifs, consultez Tarification des modèles.Exemple : wan2.7-t2v, wan2.7-t2v-2026-06-12. | |||||||||||||||||||||||||
input object (Required)Données d'entrée, incluant le prompt.
Propriétés prompt string (Required)Prompt textuel décrivant le contenu vidéo et le style visuel.Prend en charge le chinois et l'anglais. Chaque caractère ou lettre compte pour une unité. Le texte dépassant la limite est automatiquement tronqué. Longueur maximale selon le modèle :
string (Optional)Éléments à exclure de la vidéo générée.Prend en charge le chinois et l'anglais. Maximum de 500 caractères ; le texte excédentaire est automatiquement tronqué.Exemple : low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions.audio_url string (Optional)URL du fichier audio pour la génération vidéo.Formats pris en charge :
| |||||||||||||||||||||||||
parameters object (Optional)Paramètres de génération vidéo : résolution, réécriture du prompt et filigrane.
Propriétés resolution string (Optional)Niveau de résolution de la vidéo générée. Définit la clarté de sortie (nombre total de pixels).
string (Optional)Format d'image de la vidéo de sortie.
integer (Optional)Durée de la vidéo de sortie, en secondes.
boolean (Optional)Active la réécriture du prompt. Lorsqu'elle est activée, un LLM reformule le prompt d'entrée afin d'améliorer la qualité de génération. Idéal pour les prompts courts, mais augmente la latence.
boolean (Optional)Ajoute un filigrane dans le coin inférieur droit avec le texte « AI Generated ».
integer (Optional)La graine de nombre aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si aucune valeur n'est spécifiée, une graine aléatoire est générée. Une graine fixe améliore la reproductibilité.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats identiques. |
Paramètres de réponse |
Conservez le task_id pour interroger l'état et le résultat de la tâche. |
output objectSortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. |
Étape 2 : Interroger le résultat
- Beijing
- Singapore
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} par votre véritable ID d'espace de travail.
- Recommandation d'interrogation : La génération vidéo prend plusieurs minutes. Mettez en place un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 15 secondes.
- Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Une fois la tâche terminée avec succès, une URL vidéo valide pendant 24 heures est retournée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel qu'OSS.
- Validité du task_id : 24 heures. Passé ce délai, les requêtes retournent l'état
UNKNOWNpour la tâche.
Paramètres de requête |
Remplacez {task_id} par la valeur task_id retournée par l'appel API précédent. Le task_id est valide pour les requêtes pendant 24 heures, Remplacez {WorkspaceId} par votre véritable ID d'espace de travail. |
En-têtes | |
Authorization string (Required)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin | |
task_id string (Required)Identifiant de la tâche. |
Paramètres de réponse |
Les URL vidéo ne sont valides que pendant 24 heures, puis sont automatiquement supprimées. Enregistrez rapidement les vidéos générées. |
outputobjectSortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.video_url stringURL de la vidéo générée. Retournée uniquement lorsque task_status est SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.orig_prompt stringPrompt d'entrée original, correspondant au paramètre de requête prompt.code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
usage objectStatistiques de sortie. Retournées uniquement pour les tâches réussies.
Propriétés duration floatDurée totale de la vidéo, utilisée pour la facturation.Égale à output_video_duration.input_video_duration integerValeur fixe : 0.output_video_duration integerDurée de la vidéo de sortie en secondes. Correspond à la valeur input.duration.SR integerNiveau de résolution de la vidéo de sortie. Exemple : 720.ratio stringFormat d'image de la vidéo de sortie. Exemple : 16:9.video_count integerNombre de vidéos générées. Toujours égal à 1. | |
request_id stringIdentifiant unique de requête pour le suivi et le dépannage. |
HTTP (wan2.6 et versions antérieures)
Les tâches de génération vidéo à partir de texte nécessitent entre 1 et 5 minutes. L'API fonctionne donc de manière asynchrone : Créer une tâche → Interroger le résultat.
Étape 1 : Créer une tâche
- Singapore
- Virginia
- Beijing
- Frankfurt
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} par votre véritable ID d'espace de travail.
- Une fois la tâche créée, utilisez l'identifiant
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Ne créez pas de tâches en double. Privilégiez plutôt l'interrogation régulière pour obtenir le résultat. - Pour un guide destiné aux débutants, consultez la rubrique Appeler des API avec Postman ou cURL.
Paramètres de requête |
|
En-têtes de requête | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
X-DashScope-Async string (Obligatoire)Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Pour la liste des modèles et leurs tarifs, consultez la rubrique Tarification des modèles.Exemple : wan2.6-t2v. | |
input object (Obligatoire)Données d'entrée, incluant le prompt.
Propriétés prompt string (Obligatoire)Prompt textuel décrivant le contenu vidéo et le style visuel souhaités.Compatible avec le chinois et l'anglais. Chaque caractère ou lettre compte pour une unité. Le texte excédentaire est automatiquement tronqué. Longueur maximale selon le modèle :
string (Facultatif)Éléments à exclure de la vidéo générée.Compatible avec le chinois et l'anglais. Maximum de 500 caractères ; le texte plus long est tronqué automatiquement.Exemple : basse résolution, erreur, meilleure qualité, mauvaise qualité, défiguré, doigts supplémentaires, mauvaises proportions.audio_url string (Facultatif)Modèles pris en charge : séries wan2.6 et wan2.5.URL du fichier audio utilisé pour la génération vidéo.Formats acceptés :
| |
parameters object (Facultatif)Paramètres de génération vidéo : résolution, réécriture du prompt et filigrane.
Propriétés size string (Facultatif)Résolution de la vidéo de sortie au format largeur*hauteur. Les valeurs par défaut et valides dépendent du modèle :
integer (Facultatif)Durée de la vidéo de sortie en secondes. Les valeurs valides varient selon le modèle :
boolean (Facultatif)Active la réécriture du prompt. Lorsqu'elle est activée, un LLM reformule le prompt d'entrée pour améliorer la qualité. Idéal pour les prompts courts, mais ajoute de la latence.
string (Facultatif)Modèles pris en charge : modèles wan2.6.Structure des plans pour la vidéo de sortie : un plan continu unique ou plusieurs plans avec transitions.Valeurs valides :
"prompt_extend": true est défini.Priorité : shot_type prévaut sur le prompt. Définir shot_type sur single génère une vidéo à plan unique, même si le prompt demande plusieurs plans.watermark boolean (Facultatif)Ajoute un filigrane dans le coin inférieur droit portant la mention « AI Generated ».
integer (Facultatif)La graine aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si aucune valeur n'est spécifiée, une graine aléatoire est générée. Utiliser une graine fixe améliore la reproductibilité.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats strictement identiques. |
Paramètres de réponse |
Conservez le task_id pour interroger l'état et le résultat de la tâche. |
output objectSortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. |
Étape 2 : Interroger le résultat
- Singapore
- Virginia
- Beijing
- Frankfurt
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} par votre véritable ID d'espace de travail.
- Recommandation de polling : La génération vidéo prend plusieurs minutes. Mettez en place un mécanisme de polling avec un intervalle raisonnable, par exemple 15 secondes.
- Transition des états de tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Une fois la tâche terminée avec succès, une URL vidéo valide pendant 24 heures est renvoyée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel que OSS.
- Validité dutask_id:24 heures**. Passé ce délai, les requêtes renvoient le statut de la tâche comme
UNKNOWN.
Paramètres de la requête |
Remplacez {task_id} par la valeur task_id renvoyée par l'appel API précédent. Le task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail. |
Headers | |
Authorization string (Required)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Path parameters | |
task_id string (Required)Identifiant de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que pendant 24 heures, puis automatiquement supprimées. Enregistrez rapidement les vidéos générées. |
outputobjectSortie de la tâche.
Properties task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Enumeration values
stringHeure de soumission de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.video_url stringURL de la vidéo générée. Renvoyée uniquement lorsque task_status vaut SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.orig_prompt stringPrompt d'entrée original, correspondant au paramètre de requête prompt.actual_prompt stringLorsque prompt_extend=true, le système réécrit le prompt d'entrée. Ce champ contient le prompt réécrit utilisé pour la génération.
stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur. | |
usage objectStatistiques de sortie. Renvoyées uniquement pour les tâches réussies.
Properties video_duration integerRenvoyé uniquement pour wan2.5 et versions antérieures (utilisé pour la facturation).Durée de la vidéo de sortie en secondes. Valeurs valides : 5, 10.duration floatRenvoyé uniquement pour wan2.6 (utilisé pour la facturation).Durée totale de la vidéo. Formule : duration=input_video_duration+output_video_duration.input_video_duration integerRenvoyé uniquement pour wan2.6. Valeur fixe : 0.output_video_duration integerRenvoyé uniquement pour wan2.6.Durée de la vidéo de sortie en secondes. Correspond à la valeur input.duration.SR integerRenvoyé uniquement pour wan2.6. Niveau de résolution de la vidéo de sortie. Exemple : 720.size stringRenvoyé uniquement pour wan2.6. Résolution de sortie au format « largeur×hauteur ». Exemple : 1920×1080.video_ratio stringRenvoyé uniquement pour wan2.5 et versions antérieures. Résolution de sortie au format « largeur×hauteur ». Exemple : 832×480.video_count integerNombre de vidéos générées. Toujours égal à 1. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
DashScope SDK
Les noms de paramètres du SDK correspondent en grande partie à ceux de l'API HTTP, tandis que les structures suivent les conventions spécifiques à chaque langage.
Les tâches de conversion texte-en-vidéo prennent entre 1 et 5 minutes. Le SDK encapsule le flux d'appels HTTP asynchrones et prend en charge l'invocation synchrone et asynchrone.
Le temps de traitement réel dépend de la profondeur de la file d'attente et de la charge du service.
Python SDK
Définissez region selon la région du modèle (elle est passée lors de la construction du Client ; la valeur de region varie selon la région) :
- Beijing
- Singapore
- Virginia
region="cn-beijing"{WorkspaceId} par votre véritable ID d'espace de travail.
- Invocation synchrone
- Invocation asynchrone
Exemple de requête
Exemple de réponse
L'URL video_url expire après 24 heures. Téléchargez-la rapidement.
Java SDK
Définissez Constants.baseHttpApiUrl sur l'endpoint de la région :
- Singapore
- Virginia
- Beijing
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} par votre véritable ID d'espace de travail.
- Invocation synchrone
- Invocation asynchrone
Exemple de requête
Exemple de réponse
L'URL vidéo (video_url) expire au bout de 24 heures. Téléchargez-la rapidement.
Limites
- Rétention des données : l'ID de tâche (
task_id) et l'URL vidéo (video_url) expirent après 24 heures. Une fois ce délai écoulé, il n'est plus possible de les interroger ni de les télécharger. - Modération du contenu : les entrées et sorties font l'objet d'une modération automatique. Tout contenu prohibé déclenche une erreur de type « IPInfringementSuspect » ou « DataInspectionFailed ». Consultez la rubrique Codes d'erreur.
Codes d'erreur
Si l'appel au modèle échoue et renvoie un message d'erreur, reportez-vous à la rubrique Codes d'erreur pour obtenir des instructions de résolution.
FAQ
Q : Quelles modifications de code sont nécessaires pour passer de wan2.6 à wan2.7 ?
R : Deux changements s'imposent :
- Contrôle de la résolution : wan2.7 remplace le champ
size. Il utilise désormais une combinaison deresolution(niveau de résolution) et deratio(format d'image) pour définir la résolution de sortie, là où les modèles précédents recouraient au champsize. - Suppression du type de plan : le champ
shot_typedisparaît dans wan2.7. Décrivez plutôt la structure du plan directement dans le prompt.
Q : Comment convertir un lien vidéo temporaire en lien permanent ?
R : La conversion directe est impossible. Téléchargez la vidéo depuis l'URL fournie, puis importez-la vers un stockage persistant (tel qu'Alibaba Cloud OSS) afin de générer un lien permanent.
Exemple de code : Télécharger une vidéo sur un appareil local
Exemple de code : Télécharger une vidéo sur un appareil local