Le modèle Wan reference-to-video accepte une entrée multimodale et génère des vidéos d'interaction à un ou plusieurs personnages en utilisant des personnes ou des objets comme protagonistes.
Voir aussi : Guide utilisateur
Le modèle, l'URL de l'endpoint et la clé API doivent appartenir à la même région. Les appels interrégionaux échoueront.
Les tâches de génération vidéo nécessitent généralement entre 1 et 5 minutes. L'API utilise des appels asynchrones en deux étapes : « créer une tâche -> interroger le résultat ». Voici les détails :
Les paramètres du SDK suivent les mêmes conventions de nommage que l'API HTTP, avec des wrappers spécifiques au langage.
Les tâches reference-to-video nécessitent généralement entre 1 et 5 minutes. Le SDK encapsule le workflow asynchrone HTTP et prend en charge les appels synchrones et asynchrones.
Définissez
Définissez baseHttpApiUrl en fonction de la région du modèle :
Si l'appel du modèle échoue et retourne un message d'erreur, consultez Codes d'erreur pour obtenir une solution.
Disponibilité
Le modèle, l'URL de l'endpoint et la clé API doivent 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 : utilisez l'URL de l'endpoint correspondant à la région. Les URL HTTP sont prises en charge.
- Configurer la clé API : sélectionnez une région et obtenez une clé API, puis configurez la clé API comme variable d'environnement.
L'exemple de code de cette rubrique s'applique à la région Singapour.
HTTP
Les tâches de génération vidéo nécessitent généralement entre 1 et 5 minutes. L'API utilise des appels asynchrones en deux étapes : « créer une tâche -> interroger le résultat ». Voici les détails :
Étape 1 : Créer une tâche
- Singapore
- US (Virginia)
- Frankfurt
- China (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 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 la requête |
Transmettez les URL d'images et de vidéos via reference_urls. Définissez shot_type sur multi pour une vidéo à plans multiples. |
En-têtes | |
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)Modèle à utiliser. Consultez Tarification des modèles pour connaître les modèles disponibles et leurs tarifs.Exemple : wan2.6-r2v-flash. | |
input object (Obligatoire)Paramètres d'entrée tels que le prompt.
Propriétés prompt string (Obligatoire)Prompt textuel décrivant les éléments souhaités et les caractéristiques visuelles de la vidéo générée.Prend en charge le chinois et l'anglais. Chaque caractère compte pour un. Le contenu dépassant la limite est automatiquement tronqué.
string (Facultatif)Prompt négatif décrivant les éléments indésirables dans la vidéo.Prend en charge le chinois et l'anglais. Longueur maximale : 500 caractères. Le contenu dépassant la limite est automatiquement tronqué.Exemple : basse résolution, erreurs, pire qualité, basse qualité, incomplet, doigts supplémentaires, mauvaises proportions, etc.reference_urls array[string] (Obligatoire)Tableau d'URL de fichiers de référence. Prend en charge les entrées vidéo et image. Utilisé pour extraire l'apparence du personnage et sa voix (si disponible) afin de générer des vidéos correspondant aux caractéristiques de référence.
Obsolète reference_video_urls array[string]Tableau d'URL de vidéos de référence. Utilisé pour extraire l'apparence du personnage et sa voix (si disponible) afin de générer des vidéos correspondant aux caractéristiques de référence.
| |
parameters object (Facultatif)Paramètres de génération vidéo tels que la résolution, la réécriture de prompt et le filigrane.
Propriétés size string (Facultatif)Résolution de la vidéo générée, au format largeur*hauteur. La valeur par défaut et les options disponibles dépendent du paramètre model :
integer (Facultatif)Durée de la vidéo générée, en secondes.
string (Facultatif)Composition des plans de la vidéo générée, déterminant si la vidéo consiste en un seul plan continu ou en plusieurs plans.Priorité des paramètres : shot_type > prompt. Par exemple, si shot_type est défini sur « single », le modèle produit une vidéo à plan unique même si le prompt indique « générer une vidéo à plans multiples ».Valeurs valides :
Utilisez ce paramètre pour contrôler la structure narrative de la vidéo, par exemple un plan unique pour des présentations de produits ou plusieurs plans pour des extraits narratifs. boolean (Facultatif)Modèle pris en charge : wan2.6-r2v-flash.Indique s'il faut générer de l'audio dans la vidéo.Valeurs valides :
boolean (Facultatif)Indique s'il faut ajouter un filigrane. Le filigrane apparaît dans le coin inférieur droit avec le texte « AI-generated ».
integer (Facultatif)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 la réponse |
Enregistrez 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 stringID 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 la 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 : Récupérer le résultat de la tâche
- Singapore
- US (Virginia)
- Frankfurt
- China (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 prend plusieurs minutes. Utilisez 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 : après la réussite d'une tâche, une URL vidéo valide pendant 24 heures est retournée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel que OSS.
- Validité du task_id : 24 heures. Passé ce délai, les requêtes retournent l'état de la tâche comme
UNKNOWN.
Paramètres de la 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 (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que pendant 24 heures, puis sont automatiquement purgées. Enregistrez rapidement les vidéos générées. |
outputobjectSortie de la tâche.
Propriétés task_id string (Obligatoire)ID de la tâche.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 d'utilisation. Comptabilise uniquement les résultats réussis.
Propriétés input_video_duration integerDurée de la vidéo de référence d'entrée, en secondes.output_video_duration integerDurée de la vidéo de sortie, en secondes.duration floatDurée totale de la vidéo. La facturation est basée sur cette valeur.Formule : duration = input_video_duration + output_video_duration.SR integerNiveau de résolution de la vidéo générée. Exemple : 720.size stringRésolution de la vidéo générée au format largeur hauteur. Exemple : 1280720.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 paramètres du SDK suivent les mêmes conventions de nommage que l'API HTTP, avec des wrappers spécifiques au langage.
Les tâches reference-to-video nécessitent généralement entre 1 et 5 minutes. Le SDK encapsule le workflow asynchrone HTTP et prend en charge les appels synchrones et asynchrones.
Le temps de traitement réel dépend de la file d'attente des tâches et de la charge du serveur.
Python
Définissez region en fonction de la région du modèle (transmis lors de la construction du Client ; la valeur de region varie selon la région) :
- Singapore
- China (Beijing)
- Frankfurt
region="ap-southeast-1"Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Synchronous
- Asynchronous
Les appels synchrones bloquent l'exécution jusqu'à la fin de la génération vidéo et le retour du résultat.
Exemple de requête
Java
Définissez baseHttpApiUrl en fonction de la région du modèle :
- Singapore
- China (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.- Synchronous
- Asynchronous
Les appels synchrones bloquent l'exécution jusqu'à la fin de la génération vidéo et le retour du résultat.