Animez une image de personnage en transférant les mouvements d'une vidéo de référence.
- Résumé de la fonctionnalité : Transférez les actions et expressions d'une vidéo de référence vers une image de personnage pour générer une vidéo animée.
- Cas d'usage : Reproduisez des danses, des mouvements corporels complexes et des expressions faciales issus de performances cinématographiques ou télévisuelles. Cette solution constitue une alternative économique à la capture de mouvement.
Effets du modèle
Le modèle wan2.2-animate-move propose deux modes de service : le mode standard wan-std et le mode professionnel wan-pro, qui se distinguent par leur qualité de sortie et leur tarification. Pour plus d'informations, consultez Wanx-Image-to-Motion.
| Image du personnage | Vidéo de référence | Vidéo générée (mode standardwan-std) | Vidéo générée (mode professionnelwan-pro) |
|---|---|---|---|
![]() |
Prérequis
Obtenez une clé API et exportez-la en tant que variable d'environnement.
HTTP
La génération vidéo repose sur des appels asynchrones. Le processus comprend deux étapes : la création d'une tâche, puis l'interrogation des résultats.
Étape 1 : Créer une tâche et obtenir l'ID de tâche
Singapour : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
Pékin : POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/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, consultez Appeler des API avec Postman ou cURL.
Paramètres de la requête |
Voici l'URL de la région Singapour. Remplacez {WorkspaceId} par votre ID d'espace de travail Bailian. Les URL varient selon la région. |
En-têtes de requête | |
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 | |
model string (Obligatoire)Nom du modèle. Définissez ce paramètre à wan2.2-animate-move. | |
input object (Obligatoire)Paramètres d'entrée. Contient les champs suivants :
Propriétés image_url string (Obligatoire)URL HTTP ou HTTPS publiquement accessible de l'image du personnage. Les URL contenant des caractères non ASCII doivent être encodées.
string (Obligatoire)URL HTTP ou HTTPS publiquement accessible de la vidéo de référence. Les URL contenant des caractères non ASCII doivent être encodées.Recommandation : Pour obtenir de meilleurs résultats, utilisez une vidéo de référence offrant une résolution et une fréquence d'images élevées.
bool (Facultatif)Indique s'il faut ajouter un filigrane « Generated by Qwen AI » dans le coin inférieur droit de la vidéo générée.
| |
parameters object (Obligatoire)
Propriétés check_image bool (Facultatif)Indique s'il faut valider l'image d'entrée avant le traitement.
string (Obligatoire)Mode de service. Valeurs valides :
|
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 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. | |
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez Codes d'erreur. | |
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez Codes d'erreur. |
Étape 2 : Interroger le résultat par ID de tâche
- Chine (Pékin)
- Singapour
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapour
- Chine (Pékin)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {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 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 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
UNKNOWNpour la tâche.
Paramètres de la requête |
Remplacez 0385dc79-5ff8-4d82-bcb6-xxxxxx par votre véritable task_id.Voici l'URL de la région Singapour. Remplacez {WorkspaceId} par votre ID d'espace de travail Bailian. Les URL varient selon la région. |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin URL | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de 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. |
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
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.results object
Propriétés video_url stringURL de la vidéo générée. Retournée uniquement lorsque task_status vaut SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez Codes d'erreur. | |
usage objectStatistiques de sortie. Seuls les résultats réussis sont comptabilisés.
Propriétés video_duration floatDurée de la vidéo générée, en secondes.video_ratio stringMode de service utilisé pour cette requête. Valeurs d'énumération : standard et pro.wan-std retourne standard. wan-pro retourne pro. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
Limitations
Validité des données : Les ID de tâche et les URL vidéo expirent après 24 heures. Téléchargez les vidéos sans tarder.
Modération du contenu : Toutes les entrées et sorties font l'objet d'une modération automatique. Tout contenu non conforme déclenche une erreur IPInfringementSuspect ou DataInspectionFailed. Pour plus d'informations, consultez Codes d'erreur.
Facturation et limitations de débit
- Pour le quota gratuit et la tarification, consultez Wanx-Image-to-Motion.
- Pour les limites de débit, consultez Série Wan.
-
Détails de facturation :
- Seule la sortie est facturée, en fonction de la durée de la vidéo en secondes.
- Les appels échoués sont gratuits et n'entament pas le quota gratuit nouvel utilisateur.
Codes d'erreur
Si un appel de modèle échoue et retourne un message d'erreur, consultez Codes d'erreur.
FAQ
Comment améliorer la qualité de la vidéo générée ?
- Veillez à ce que le personnage occupe une proportion similaire du cadre dans l'image d'entrée et dans la vidéo de référence.
- Maintenez des proportions corporelles cohérentes entre l'image et la vidéo.
- Utilisez des sources haute définition. Des images floues ou des vidéos à faible fréquence d'images dégradent la qualité de sortie.
Comment convertir un lien vidéo temporaire en lien permanent ?
La conversion directe du lien est impossible. Téléchargez la vidéo depuis votre backend, puis importez-la dans un stockage objet permanent (tel qu'OSS) pour obtenir une URL permanente.
Exemple de code : Télécharger la vidéo sur un appareil local
Exemple de code : Télécharger la vidéo sur un appareil local
