Le modèle Wan 2,2 génère une vidéo avec des transitions fluides à partir d'une première image , d'une dernière image et d'un prompt textuel .
Documents associés : Guide utilisateur
Pour garantir le succès des appels API, votre modèle, votre URL d'endpoint et votre clé API doivent se trouver dans la même région. Les appels interrégionaux échoueront.
Les tâches image-vers-vidéo étant des opérations longues (généralement de 1 à 5 minutes), l'API utilise un appel asynchrone. Le processus comprend deux étapes principales : créer une tâche, puis interroger régulièrement pour obtenir le résultat.
Les noms de paramètres du SDK sont largement cohérents avec ceux de l'API HTTP, et la structure des paramètres suit les conventions de chaque langage de programmation.
Les tâches image-vers-vidéo étant longues (généralement de 1 à 5 minutes), le SDK gère les appels HTTP asynchrones en interne, prenant en charge les méthodes d'appel synchrones et asynchrones.
Définissez
En cas d'échec d'un appel de modèle, consultez Codes d'erreur pour le dépannage.
R : Le rapport d'aspect de la vidéo de sortie dépend de la première image (first_frame_url). Cependant, un rapport exact (tel qu'un strict 3:4) ne peut être garanti et peut présenter de légères variations.
R : Les vidéos générées par les modèles sont stockées dans OSS. L'API retourne une URL publique temporaire. Pour configurer une liste d'autorisation de pare-feu pour cette URL de téléchargement, notez ce qui suit : le stockage sous-jacent peut changer dynamiquement. Cette rubrique ne fournit pas de liste d'autorisation de noms de domaine OSS fixe afin d'éviter les problèmes d'accès causés par des informations obsolètes. Si vous avez des exigences de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.
Remarques sur l'utilisation
Pour garantir le succès des appels API, votre modèle, votre URL d'endpoint et votre clé API doivent se trouver dans la même région. Les appels interrégionaux échoueront.
- Sélectionner un modèle : confirmez la région où le modèle est disponible.
- Sélectionner une URL : choisissez l'URL d'endpoint correspondant à votre région. Les URL HTTP et les URL du SDK DashScope sont toutes deux prises en charge.
- Configurer votre clé API : sélectionnez une région, obtenez votre clé API, puis définissez-la comme variable d'environnement.
- Installer le SDK : pour effectuer des appels API via le SDK, installez le SDK DashScope.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
Appel HTTP
Les tâches image-vers-vidéo étant des opérations longues (généralement de 1 à 5 minutes), l'API utilise un appel asynchrone. Le processus comprend deux étapes principales : créer une tâche, puis interroger régulièrement pour obtenir le résultat.
Étape 1 : Créer une tâche
- Singapore
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/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 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 la requête |
Génère une vidéo à partir d'une première image, d'une dernière image et d'un prompt. |
En-têtes de la requête | |
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. Exemple : wan2.2-kf2v-flash.Pour plus de détails, consultez la console Model Studio. | |
input object (Required)Contient les données d'entrée principales de la tâche, telles que le prompt.
Propriétés prompt string (Optional)Prompt textuel. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères. Les caractères chinois et les lettres comptent chacun pour un seul caractère. Le texte dépassant cette limite est tronqué.En cas de changements significatifs de sujet ou de scène entre la première et la dernière image, nous vous recommandons de décrire le processus de transition, par exemple un mouvement de caméra (« la caméra se déplace vers la gauche ») ou un mouvement du sujet (« une personne court vers l'avant »).Exemple : « Un petit chat noir regarde le ciel avec curiosité. La caméra s'élève progressivement depuis le niveau des yeux et capture finalement son regard curieux selon une vue de dessus. »Pour obtenir des conseils sur la rédaction de prompts efficaces, consultez le guide des prompts pour le texte-vers-vidéo et l'image-vers-vidéo.negative_prompt string (Optional)Prompt négatif décrivant le contenu à exclure de la vidéo, ce qui permet de contraindre la sortie.Prend en charge le chinois et l'anglais. La longueur maximale est de 500 caractères. Le texte dépassant cette limite est tronqué.Exemple : « low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions ».first_frame_url string (Required)URL de la première image. Le rapport d'aspect de la vidéo de sortie correspondra à celui de cette première image.L'URL doit être une adresse accessible publiquement prenant en charge le protocole HTTP ou HTTPS.Exigences relatives à l'image :
string (Required)URL de la dernière image.L'URL doit être une adresse accessible publiquement prenant en charge le protocole HTTP ou HTTPS.Exigences relatives à l'image :
| |
parameters object (Optional)Paramètres de traitement vidéo.
Propriétés resolution string (Optional)Résolution de la vidéo générée. Ce paramètre ajuste la définition (nombre total de pixels) sans modifier le rapport d'aspect.La valeur par défaut et les valeurs disponibles pour ce paramètre dépendent du modèle, comme décrit ci-dessous :
integer (Optional)Cette valeur est fixée à 5.prompt_extendbool (Optional)Indique s'il faut activer la réécriture du prompt. Lorsqu'elle est activée, un grand modèle de langage (LLM) réécrit intelligemment le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente la latence.
bool (Optional)Indique s'il faut ajouter un filigrane portant la mention « AI-generated » dans le coin inférieur droit de la vidéo.
integer (Optional)La graine de nombre aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si elle n'est pas 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 objectInformations de sortie 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 : Interroger le résultat
- Singapore
- 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 86ecf553-d340-4e21-xxxxxxxxx par votre véritable task_id.Les clés API diffèrent selon les régions. Pour plus d'informations, consultez Obtenir une clé API. Si vous utilisez un modèle dans la région Chine (Pékin), remplacez |
En-têtes de la requête | |
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)ID de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que pendant 24 heures, puis automatiquement purgées. Enregistrez rapidement les vidéos générées. |
outputobjectInformations de sortie 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
stringHeure de soumission de la tâche. L'heure est au format 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 au format 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 au format 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.actual_prompt stringPrompt optimisé utilisé lorsque la réécriture du prompt est activée. Non retourné lorsqu'elle est désactivée.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 de la tâche. Seules les tâches réussies sont facturées.
Propriétés video_duration integerDurée de la vidéo générée en secondes, toujours égale à 5. Formule de facturation : Coût = Secondes vidéo × Prix unitaire.video_count integerNombre de vidéos générées. Cette valeur est fixée à 1.video_ratio stringCette valeur n'est actuellement retournée que par le modèle 2,1. Rapport d'aspect de la vidéo générée, fixé à standard.SR integerCette valeur n'est actuellement retournée que par le modèle 2,2. Niveau de résolution de la vidéo générée. Les valeurs possibles sont 480, 720 et 1080. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
Appels via le SDK DashScope
Les noms de paramètres du SDK sont largement cohérents avec ceux de l'API HTTP, et la structure des paramètres suit les conventions de chaque langage de programmation.
Les tâches image-vers-vidéo étant longues (généralement de 1 à 5 minutes), le SDK gère les appels HTTP asynchrones en interne, prenant en charge les méthodes d'appel synchrones et asynchrones.
Le temps de traitement réel dépend du nombre de tâches en file d'attente et des performances du service. Veuillez patienter.
Appels via le SDK 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
- Beijing
region="ap-southeast-1"Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Exemple de code
- Synchronous call
- Asynchronous call
Cet exemple illustre un appel synchrone avec deux méthodes de saisie d'image : une URL publique et un chemin de fichier local.
Exemple de requête
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Veuillez télécharger la vidéo dans ce délai.
Appels via le SDK Java
Exemple de code
- Synchronous call
- Asynchronous call
Cet exemple illustre un appel synchrone avec deux méthodes de saisie d'image : URL publique et chemin de fichier local.
Exemple de requête
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Veuillez télécharger la vidéo dans ce délai.
Limites
- Rétention des données : le
task_idde la tâche et l'URLvideo_urlde la vidéo sont conservés pendant 24 heures, après quoi ils ne peuvent plus être interrogés ni téléchargés. - Prise en charge audio : le service génère uniquement des vidéos muettes. Pour générer de l'audio, utilisez la synthèse vocale.
- Modération de contenu : la modération de contenu examine tous les prompts d'entrée, les images et les vidéos de sortie. Si un contenu enfreint les politiques d'utilisation, le service retourne une erreur « IPInfringementSuspect » ou « DataInspectionFailed ». Pour plus de détails, consultez Codes d'erreur.
Codes d'erreur
En cas d'échec d'un appel de modèle, consultez Codes d'erreur pour le dépannage.
FAQ
Q : Comment générer un rapport d'aspect spécifique ?
R : Le rapport d'aspect de la vidéo de sortie dépend de la première image (first_frame_url). Cependant, un rapport exact (tel qu'un strict 3:4) ne peut être garanti et peut présenter de légères variations.
-
Pourquoi le rapport d'aspect varie-t-il ?
Le modèle utilise le rapport d'aspect de l'image d'entrée comme référence et calcule la résolution valide la plus proche en fonction du nombre total de pixels du paramètre
resolutionsélectionné. Comme la largeur et la hauteur de la vidéo doivent être des multiples de 16, le modèle apporte des ajustements mineurs à la résolution finale.- Par exemple, si vous fournissez une image d'entrée de 750×1000 (rapport d'aspect de 3:4 ou 0,75) et définissez
resolutionsur « 720P » (visant environ 920 000 pixels), la sortie réelle pourrait être de 816×1104 (rapport d'aspect d'environ 0,739, avec près de 900 000 pixels).
- Par exemple, si vous fournissez une image d'entrée de 750×1000 (rapport d'aspect de 3:4 ou 0,75) et définissez
-
Recommandations :
- Image d'entrée : pour de meilleurs résultats, utilisez une première image correspondant à votre rapport d'aspect cible.
- Post-traitement : si un rapport d'aspect strict est requis, utilisez un outil de montage vidéo pour recadrer la vidéo générée ou ajouter des bandes noires.