Le modèle texte-vers-vidéo Wan génère des vidéos fluides à partir d' invites textuelles .
Références : Guide d'utilisation
Pour garantir le succès des appels, le modèle, l'URL de l'endpoint et la clé API doivent tous appartenir à la même région. Les appels interrégionaux échoueront.
Les tâches texte-vers-vidéo nécessitant un temps de traitement important (généralement 1 à 5 minutes), l'API recourt à une invocation asynchrone. L'ensemble du processus comprend deux étapes principales : Créer une tâche -> Interroger le résultat. Le déroulement est le suivant :
Les noms de paramètres du SDK correspondent en grande partie à ceux de l'API HTTP, et leur structure est encapsulée pour s'aligner sur les spécificités du langage de programmation.
Les tâches texte-vers-vidéo pouvant prendre beaucoup de temps (généralement 1 à 5 minutes), le SDK encapsule le processus d'appel asynchrone HTTP et prend en charge les modes d'invocation synchrone et asynchrone.
Définissez
Définissez Constants.baseHttpApiUrl en fonction de la région où se trouve le modèle :
Si l'appel du modèle échoue et retourne un message d'erreur, consultez les Codes d'erreur pour obtenir une solution.
R : Il est impossible de convertir directement le lien. La procédure correcte consiste à faire récupérer l'URL par votre service backend, à télécharger le fichier vidéo, puis à le transférer vers un service de stockage d'objets permanent, tel qu'Alibaba Cloud Object Storage Service (OSS), afin de générer un nouveau lien d'accès permanent.
R : Non. Vous ne devez pas lire le lien directement dans un navigateur car il expire au bout de 24 heures. Téléchargez et stockez plutôt la vidéo, puis utilisez un lien permanent pour la lecture.
Disponibilité
Pour garantir le succès des appels, le modèle, l'URL de l'endpoint et la clé API doivent tous appartenir à la même région. Les appels interrégionaux échoueront.
- Sélectionner un modèle : Confirmez la région du modèle.
- Sélectionner une URL : Choisissez l'URL d'endpoint régionale correspondante. Les URL HTTP et les URL du SDK DashScope sont prises en charge.
- Configurer une clé API : Sélectionnez une région, obtenez une clé API, puis configurez la clé API comme variable d'environnement (fonctionnalité devant être obsolète et fusionnée dans la configuration de la clé API).
- Installer le SDK : Pour effectuer des appels via le SDK, vous devez installer le SDK DashScope.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
HTTP
Les tâches texte-vers-vidéo nécessitant un temps de traitement important (généralement 1 à 5 minutes), l'API recourt à une invocation asynchrone. L'ensemble du processus comprend deux étapes principales : Créer une tâche -> Interroger le résultat. Le déroulement est le suivant :
Étape 1 : Créer une tâche et obtenir l'ID de tâche
- Singapore
- Virginia
- Frankfurt
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisRemplacez {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. Utilisez plutôt l'interrogation périodique 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 |
|
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 avec 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 à utiliser. Pour consulter la liste des modèles disponibles, reportez-vous à la liste des modèles.Exemple : wan2.6-t2v. | |
input object (Obligatoire)Contient les informations d'entrée de base, telles que l'invite.
Propriétés prompt string (Obligatoire)Invite textuelle décrivant les éléments souhaités et les caractéristiques visuelles de la vidéo générée.L'invite peut être rédigée en chinois ou en anglais. Sa longueur est mesurée en caractères, chaque caractère chinois ou lettre comptant pour un. Le texte dépassant la limite est automatiquement tronqué. Cette limite varie selon la version du modèle :
string (Facultatif)Invite décrivant le contenu à exclure de la vidéo, permettant d'affiner le résultat généré.Rédigée en chinois ou en anglais, elle ne doit pas excéder 500 caractères. Le texte dépassant cette limite est automatiquement tronqué.Exemple : basse résolution, erreur, meilleure qualité, mauvaise qualité, déformé, 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 que le modèle utilisera pour générer la vidéo.Formats d'entrée pris en charge :
| |
parameters object (Facultatif)Paramètres de traitement vidéo, tels que la définition de la résolution, l'activation de la réécriture d'invite ou l'ajout d'un filigrane.
Propriétés size string (Facultatif)Spécifie la résolution de la vidéo générée au format largeur*hauteur. La valeur par défaut et les valeurs valides dépendent du paramètre model, comme détaillé ci-dessous :
integer (Facultatif)Durée de la vidéo générée, exprimée en secondes. Les valeurs valides dépendent du paramètre model :
boolean (Facultatif)Indique si la réécriture de l'invite est activée. Lorsque cette option est active, le modèle reformule intelligemment l'invite d'entrée, ce qui améliore considérablement la qualité vidéo pour les invites courtes, mais augmente le temps de traitement.
string (Facultatif)Modèles pris en charge : wan2.6.Définit le type de plan de la vidéo générée, c'est-à-dire si elle se compose d'un seul plan continu ou de plusieurs plans changeants.Valeurs valides :
"prompt_extend": true est défini.Priorité des paramètres : shot_type > prompt. Par exemple, si shot_type est défini sur « single », le modèle produira une vidéo à plan unique même si l'invite contient « générer une vidéo multi-plans ».watermark boolean (Facultatif)Indique s'il faut ajouter un filigrane. Celui-ci apparaît dans le coin inférieur droit de la vidéo avec le texte fixe « 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. 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 objectContient les informations de sortie 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 requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. |
Étape 2 : Interroger le résultat par ID de tâche
- Singapore
- Virginia
- Frankfurt
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- 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 15 secondes.
- Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien de résultat : Après le succès d'une tâche, une URL vidéo valide 24 heures est retournée. Téléchargez et sauvegardez la vidéo dans un stockage permanent, tel qu'OSS.
- Validité dutask_id : 24 heures. Passé ce délai, les requêtes retournent l'état
UNKNOWN.
Paramètres de 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 | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin d'URL | |
task_id string (Obligatoire)Identifiant de la tâche. |
Paramètres de réponse |
Les URL vidéo ne sont valides que 24 heures avant d'être automatiquement purgées. Sauvegardez rapidement les vidéos générées. |
outputobjectContient les informations de sortie 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
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 stringInvite d'entrée originale, correspondant au paramètre de requête prompt.actual_prompt stringLorsque prompt_extend=true, le système réécrit l'invite d'entrée. Ce champ retourne l'invite optimisée utilisée pour la génération.
stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
usage objectContient des statistiques sur la sortie. Ces informations ne sont fournies que pour les tâches réussies.
Propriétés video_duration integerRetourné uniquement avec les modèles wan2.5 et antérieurs. Utilisé pour la facturation.Durée de la vidéo générée en secondes. Les valeurs valides sont 5 et 10.duration floatRetourné uniquement avec le modèle wan2.6. Utilisé pour la facturation.Indique la durée totale de la vidéo, où duration = input_video_duration + output_video_duration.input_video_duration integerRetourné uniquement avec le modèle wan2.6. Fixé à 0.output_video_duration integerRetourné uniquement avec le modèle wan2.6.Durée de la vidéo de sortie en secondes. Sa valeur est identique à celle de input.duration.SR integerRetourné uniquement avec le modèle wan2.6. Niveau de résolution de la vidéo générée. Exemple : 720.size stringRetourné uniquement avec le modèle wan2.6. Résolution de la vidéo générée. Format : « largeurhauteur ». Exemple : 19201080.video_ratio stringRetourné uniquement avec les modèles wan2.5 et antérieurs. Résolution de la vidéo générée. Format : « largeurhauteur ». Exemple : 832480.video_count integerNombre de vidéos générées. Fixé à 1. | |
request_id stringIdentifiant unique de requête pour le suivi et le dépannage. |
SDK DashScope
Les noms de paramètres du SDK correspondent en grande partie à ceux de l'API HTTP, et leur structure est encapsulée pour s'aligner sur les spécificités du langage de programmation.
Les tâches texte-vers-vidéo pouvant prendre beaucoup de temps (généralement 1 à 5 minutes), le SDK encapsule le processus d'appel asynchrone HTTP et prend en charge les modes d'invocation synchrone et asynchrone.
Le temps de traitement réel dépend du nombre de tâches en attente et de l'état du service. Patientez jusqu'à l'obtention du résultat.
Python
Définissez region en fonction de la région où se trouve le modèle (transmis lors de la construction du Client ; la valeur de region varie selon la région) :
- Singapore
- Virginia
- Beijing
- Frankfurt
region="ap-southeast-1"Remplacez {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 est valide pendant 24 heures. Téléchargez-la rapidement.
Java
Définissez Constants.baseHttpApiUrl en fonction de la région où se trouve le modèle :
- Singapore
- Virginia
- Beijing
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Remplacez {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 est valide pendant 24 heures. Téléchargez-la rapidement.
Codes d'erreur
Si l'appel du modèle échoue et retourne un message d'erreur, consultez les Codes d'erreur pour obtenir une solution.
FAQ
Q : Comment convertir un lien vidéo temporaire en lien permanent ?
R : Il est impossible de convertir directement le lien. La procédure correcte consiste à faire récupérer l'URL par votre service backend, à télécharger le fichier vidéo, puis à le transférer vers un service de stockage d'objets permanent, tel qu'Alibaba Cloud Object Storage Service (OSS), afin de générer un nouveau lien d'accès 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