Wan3.0 est un modèle tout-en-un de génération vidéo basé sur des références. Il prend en charge les modes Texte vers vidéo , Image vers vidéo (première image / première et dernière images) et Génération vidéo basée sur des références . Ce modèle permet de générer des vidéos d'une durée maximale de 30 secondes.
Prérequis
Pour garantir le succès de vos appels API, assurez-vous que le modèle, l'URL de l'endpoint et la clé API appartiennent tous à la même région. Les appels interrégionaux échouent systématiquement.
- Sélectionner un modèle : Accédez à la galerie de modèles pour en choisir un et confirmer sa région.
- Choisir une URL : Sélectionnez l'URL de l'endpoint correspondant à votre région.
- Configurer la clé API : Choisissez une région, puis Obtenez une clé API. Ensuite, Configurez cette clé comme variable d'environnement.
Les exemples de code de cette rubrique s'appliquent à la région de Singapour.
Appel HTTP
La génération vidéo nécessitant un temps de traitement relativement long (généralement entre 1 et 5 minutes), l'API fonctionne de manière asynchrone. Le processus complet se déroule en deux étapes principales : « Création d'une tâche -> Interrogation des résultats », détaillées ci-dessous :
Étape 1 : Créer une tâche et obtenir son ID
- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Évitez de créer des tâches en double ; privilégiez plutôt l'interrogation périodique pour récupérer le résultat. - Pour un guide destiné aux débutants, reportez-vous à Appeler des API avec Postman ou cURL.
Paramètres de la requête |
Transmettez un fichier via le type file ; le modèle analysera automatiquement son contenu pour générer la vidéo. |
En-têtes de requête (Headers) | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à 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 (Request Body) | |
model string (Obligatoire)Nom du modèle. Valeur fixe : wan3.0-video. | |
input object (Obligatoire)Informations d'entrée de base. Vous devez fournir soit prompt, soit media.
Propriétés prompt string (Conditionnellement obligatoire)Invite textuelle décrivant le contenu vidéo souhaité. Ce champ ou media doit être renseigné.Prend en charge le chinois et l'anglais. Chaque caractère chinois ou lettre compte pour un caractère, avec une limite maximale de 20 000 caractères. Tout contenu dépassant cette limite sera automatiquement tronqué.En mode référence, vous pouvez utiliser « Image 1 », « Vidéo 1 », etc. dans l'invite pour désigner les ressources multimédias selon leur ordre d'apparition dans le tableau media.media array (Conditionnellement obligatoire)Tableau de ressources multimédias acceptant des images, vidéos, fichiers audio, documents et pages web en entrée. Ce champ ou prompt doit être renseigné.
Propriétés type string (Obligatoire)Type de ressource multimédia. Valeurs valides :
string (Obligatoire)URL de la ressource multimédia ou données encodées en Base64.
Image d'entrée (type=first_frame / last_frame / reference_image) URL de l'image ou données encodées en Base64.Contraintes relatives aux images :
Vidéo d'entrée (type=reference_video) URL de la vidéo de référence.Contraintes relatives aux vidéos :
Audio d'entrée (type=reference_audio) URL du fichier audio de référence.Contraintes relatives aux fichiers audio :
Fichier d'entrée (type=file) URL du fichier.Contraintes relatives aux fichiers :
Lien web d'entrée (type=link) URL d'une page web publique. Seules les pages accessibles publiquement sans authentification (articles de presse, blogs, comptes publics, etc.) peuvent être analysées.Formats d'entrée pris en charge :
| |
parameters object (Facultatif)Paramètres de traitement vidéo.
Propriétés resolution string (Facultatif)Niveau de résolution de la vidéo générée. Valeur par défaut : 1080P. Valeurs valides :
string (Facultatif)Rapport hauteur/largeur de la vidéo générée. Valeurs valides :
integer (Facultatif)Durée de la vidéo générée, exprimée en secondes. Valeur par défaut : 5.
boolean (Facultatif)Indique si la vidéo générée doit contenir une piste audio.
integer (Facultatif)Graine aléatoire permettant de reproduire les résultats de génération. Plage de valeurs : [0, 2147483647].watermark boolean (Facultatif)Indique s'il faut ajouter un filigrane.
|
Paramètres de la réponse |
Conservez le task_id afin de pouvoir interroger ultérieurement l'état et le résultat de la tâche. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringIdentifiant unique 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. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. |
Étape 2 : Interroger les résultats à l'aide de l'ID de tâche
- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}- Recommandation d'interrogation : La génération vidéo prenant plusieurs minutes, mettez en place un mécanisme d'interrogation périodique avec un intervalle raisonnable (par exemple, toutes les 15 secondes).
- Transition des états de tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien de 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 sauvegardez rapidement la vidéo dans un stockage permanent, tel qu'OSS.
- Validité dutask_id:24 heures**. Passé ce délai, toute interrogation retourne l'état
UNKNOWN.
Paramètres de la requête |
Remplacez {task_id} par la valeur task_id retournée lors de 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. |
En-têtes de requête (Headers) | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin URL (Path parameters) | |
task_id string (Obligatoire)Identifiant unique de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que pendant 24 heures avant d'être automatiquement supprimées. Pensez à sauvegarder rapidement vos vidéos générées. |
output objectInformations de sortie de la tâche.
Propriétés task_id string (Obligatoire)Identifiant unique de la tâche.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est indiquée au fuseau 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 indiquée au fuseau 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 indiquée au fuseau UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.orig_prompt stringInvite d'entrée originale.video_url stringURL de la vidéo générée. Retournée uniquement lorsque la tâche aboutit avec succès. Le format vidéo est MP4 (encodage H.264).code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
usage objectStatistiques de sortie. Ne comptabilise que les résultats réussis.
Propriétés video_count integerNombre de vidéos générées. Toujours fixé à 1.duration integerDurée totale de la vidéo, en secondes. En l'absence de vidéo de référence en entrée, elle est égale à la durée de la vidéo de sortie ; lorsqu'une vidéo de référence est fournie en entrée, elle est égale à la somme de la durée de la vidéo d'entrée et de la durée de la vidéo de sortie.input_video_duration integerDurée de la vidéo fournie en entrée, en secondes. Vaut 0 si aucune vidéo n'a été transmise.output_video_duration integerDurée de la vidéo générée en sortie, en secondes.fps integerFréquence d'images de la vidéo générée.SR integerRésolution de la vidéo générée. Exemple : 720.ratio stringRapport hauteur/largeur de la vidéo générée. Exemple : 16:9. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. |