Alibaba Cloud Model Studio:Wan image-to-action API reference

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

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
        --header 'X-DashScope-Async: enable' \
        --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
        --header 'Content-Type: application/json' \
        --data '{
            "model": "wan2.2-animate-move",
            "input": {
                "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
                "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4",
                "watermark": true
            },
            "parameters": {
                "mode": "wan-std"
            }
          }'

{
        "output": {
            "task_status": "PENDING",
            "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
        },
        "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
    }

{
        "code": "InvalidApiKey",
        "message": "No API-key provided.",
        "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
    }

Étape 2 : Interroger le résultat par ID de tâche

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
        --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5,2,
        "video_ratio": "standard"
    }
}

{
        "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
        "output": {
            "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
            "task_status": "FAILED",
            "code": "InternalError",
            "message": "xxxxxx"
        }
    }

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 ?

1. 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.
2. Maintenez des proportions corporelles cohérentes entre l'image et la vidéo.
3. 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.

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # Set timeout
        response.raise_for_status() # If the HTTP status code is not 200, raise an exception
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Video downloaded successfully to: {save_path}")
        # You can add the logic to upload to permanent storage here
    except requests.exceptions.RequestException as e:
        print(f"Failed to download video: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Puis-je lire directement le lien vidéo retourné dans un navigateur ?

Ce n'est pas recommandé. Le lien expire au bout de 24 heures. Téléchargez et enregistrez la vidéo depuis votre backend, puis diffusez-la via un lien permanent.

Comment obtenir la liste d'autorisation de noms de domaine pour le stockage vidéo ?

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 fixe de noms de domaine OSS afin d'éviter les problèmes d'accès liés à des informations obsolètes. Si vous avez des exigences en matière de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.