Alibaba Cloud Model Studio:Referencia de la API de imagen a acción de Wan

Anime una imagen de personaje transfiriendo acciones desde un video de referencia.

• Resumen de funciones: Transfiere acciones y expresiones de un video de referencia a una imagen de personaje para generar un video animado.
• Escenarios: Replicar bailes, movimientos corporales complejos y expresiones faciales de actuaciones cinematográficas y televisivas. Una alternativa de bajo costo a la captura de movimiento.

Efectos del modelo

El modelo wan2.2-animate-move admite dos modos de servicio: modo estándar wan-std y modo profesional wan-pro, que difieren en calidad de salida y precios. Para más información, consulte Wanx-Image-to-Motion.

Imagen del personaje	Video de referencia	Video de salida (modo estándarwan-std)	Video de salida (modo profesionalwan-pro)

Requisitos previos

Obtenga una clave API y exporte la clave API como variable de entorno.

HTTP

La generación de video utiliza llamadas asíncronas. El proceso tiene dos pasos: crear una tarea y luego sondear para obtener resultados.

Paso 1: Crear una tarea y obtener el ID de tarea

Singapur: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

Beijing: 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": "Invalid API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Paso 2: Consultar el resultado por ID de tarea

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"
    }
}

Limitaciones

Validez de datos: Los ID de tarea y las URLs de video caducan después de 24 horas. Descargue los videos oportunamente.

Moderación de contenido: Todas las entradas y salidas se moderan automáticamente. El contenido no conforme devuelve un error IPInfringementSuspect o DataInspectionFailed. Para más información, consulte Códigos de error.

Facturación y limitación de tasa

• Para cuotas gratuitas y precios, consulte Wanx-Image-to-Motion.

• Para límites de tasa, consulte la serie Wan.

• Detalles de facturación:

  • Solo se factura la salida, basada en la duración del video en segundos.
  • Las llamadas fallidas son gratuitas y no consumen la cuota gratuita para nuevos usuarios.

Códigos de error

Si una llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error.

FAQ

¿Cómo puedo mejorar la calidad del video de salida?

1. Asegúrese de que el personaje ocupe una proporción similar del encuadre tanto en la imagen de entrada como en el video de referencia.
2. Mantenga las proporciones corporales consistentes entre la imagen y el video.
3. Utilice materiales fuente de alta definición. Las imágenes borrosas o los videos con baja tasa de cuadros reducen la calidad de salida.

¿Cómo puedo convertir un enlace de video temporal en uno permanente?

El enlace no se puede convertir directamente. Descargue el video desde su backend y cárguelo en un almacenamiento de objetos permanente (como OSS) para obtener una 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)

¿Puedo reproducir el enlace de video devuelto directamente en un navegador?

No se recomienda. El enlace caduca después de 24 horas. Descargue y guarde el video desde su backend, y luego sírvalo mediante un enlace permanente.

¿Cómo obtengo la lista blanca de nombres de dominio para el almacenamiento de videos?

R: Los videos generados por los modelos se almacenan en OSS. La API devuelve una URL pública temporal. Para configurar una lista blanca de firewall para esta URL de descarga, tenga en cuenta lo siguiente: El almacenamiento subyacente puede cambiar dinámicamente. Este tema no proporciona una lista blanca fija de nombres de dominio de OSS para evitar problemas de acceso causados por información obsoleta. Si tiene requisitos de control de seguridad, póngase en contacto con su gerente de cuenta para obtener la lista más reciente de nombres de dominio de OSS.