Skip to main content

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 personajeVideo de referenciaVideo de salida (modo estándarwan-std)Video de salida (modo profesionalwan-pro)
move_input_image

Requisitos previos

Obtenga una clave API y exporte la clave API como variable de entorno.
Las regiones de China (Pekín) y Singapur tienen claves de API y endpoints de solicitud separados. No pueden utilizarse indistintamente. Las llamadas entre regiones provocan fallos de autenticación o errores de servicio.
Alibaba Cloud Model Studio ha lanzado dominios específicos de espacio de trabajo para las regiones de China (Beijing) y Singapur. Los nuevos dominios dedicados ofrecen un rendimiento superior y una mayor estabilidad para las solicitudes de inferencia. Recomendamos migrar a los nuevos dominios:
  • China (Pekín): de https://dashscope.aliyuncs.com a https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapur: de https://dashscope-intl.aliyuncs.com a https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} es su ID de espacio de trabajo, que se encuentra en la página Workspace Details de la consola de Alibaba Cloud Model Studio. El dominio existente permanece totalmente funcional.

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
  • Después de crear la tarea, utilice el task_id devuelto para consultar el resultado. El task_id es válido durante 24 horas. No cree tareas duplicadas. En su lugar, utilice el sondeo para recuperar el resultado.
  • Para obtener orientación para principiantes, consulte Llamar a APIs con Postman o cURL.

Parámetros de solicitud

Encabezados de solicitud
Content-Type string (Requerido)El tipo de contenido de la solicitud. Debe ser application/json.Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.X-DashScope-Async string (Requerido)Habilita el procesamiento asíncrono. Las solicitudes HTTP solo admiten llamadas asíncronas. Debe ser enable.
Si falta este encabezado de solicitud, se devuelve el error "current user api does not support synchronous calls".
Cuerpo de la solicitud
model string (Obligatorio)El nombre del modelo. Establezca este parámetro en wan2.2-animate-move.input object (Obligatorio)Los parámetros de entrada. Contiene los siguientes campos:

Propiedades

image_url string (Obligatorio)Una URL HTTP o HTTPS de acceso público de la imagen del personaje. Las URLs que contienen caracteres no ASCII deben estar codificadas en URL.
  • Formato: JPG, JPEG, PNG, BMP o WEBP
  • Dimensiones: El ancho y el alto deben estar ambos en el rango de [200, 4096] píxeles. La relación de aspecto debe estar entre 1:3 y 3:1.
  • Tamaño de archivo: No más de 5 MB
  • Ejemplo: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg
video_url string (Obligatorio)Una URL HTTP o HTTPS de acceso público del video de referencia. Las URLs que contienen caracteres no ASCII deben estar codificadas en URL.Recomendación: Para obtener mejores resultados, utilice un video de referencia con mayor resolución y tasa de cuadros.
  • Formato: MP4, AVI o MOV
  • Duración: De 2 a 30 segundos
  • Dimensiones: El ancho y el alto deben estar ambos en el rango de [200, 2048] píxeles. La relación de aspecto debe estar entre 1:3 y 3:1.
  • Tamaño de archivo: No más de 200 MB
  • Ejemplo: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4
watermark bool (Opcional)Si se debe agregar una marca de agua "Generado por IA Qwen" en la esquina inferior derecha del video de salida.
  • false (predeterminado)
  • true
parameters object (Obligatorio)

Propiedades

check_image bool (Opcional)Si se debe validar la imagen de entrada antes del procesamiento.
  • true (predeterminado)
  • false
mode string (Obligatorio)El modo de servicio. Valores válidos:
  • wan-std: Modo estándar. Generación más rápida a menor costo. Adecuado para vistas previas rápidas y animación básica.
  • wan-pro: Modo profesional. Animación más fluida y mayor calidad, con mayor tiempo de procesamiento y costo más elevado.
Para más información, consulte Efectos del modelo y Facturación y límites de tasa.
  • Imagen a acción
La siguiente es la URL de la región Singapore. Reemplace {WorkspaceId} con su ID de espacio de trabajo de Bailian. Las URLs varían según la región.
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"
        }
      }'

Parámetros de respuesta

output objectLa salida de la tarea.

Propiedades

task_id stringEl ID de la tarea. Válido para consultas durante 24 horas.task_status stringEl estado de la tarea.

Valores de enumeración

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: La tarea no existe o se desconoce su estado.
request_id stringIdentificador único de solicitud para rastreo y solución de problemas.message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.code stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.
  • Respuesta exitosa
  • Respuesta de error
Guarde el task_id para consultar el estado y el resultado de la tarea.
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

Paso 2: Consultar el resultado por ID de tarea

  • Singapore
  • China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Al realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.
  • Recomendación de sondeo: La generación de video tarda varios minutos. Utilice un mecanismo de sondeo con un intervalo razonable, como 15 segundos.
  • Transición de estado de la tarea: PENDING → RUNNING → SUCCEEDED o FAILED.
  • Enlace de resultado: Después de que una tarea tenga éxito, se devuelve una URL de video válida durante 24 horas. Descargue y guarde el video en un almacenamiento permanente, como OSS.
  • task_idvalidez: 24 horas. Después de este período, las consultas devuelven el estado de la tarea como UNKNOWN.

Parámetros de solicitud

Encabezados de solicitud
Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.
Parámetros de ruta de URL
task_id string (Obligatorio)El ID de la tarea.
  • Consultar resultado de la tarea
Reemplace 0385dc79-5ff8-4d82-bcb6-xxxxxx con su task_id real.
La siguiente es la URL de la región de Singapur. Reemplace {WorkspaceId} con su ID de espacio de trabajo de Bailian. Las URLs varían según la región. 
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"

Parámetros de respuesta

output objectLa salida de la tarea.

Propiedades

task_id stringEl ID de la tarea. Válido para consultas durante 24 horas.task_status stringEl estado de la tarea.

Valores de enumeración

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: La tarea no existe o se desconoce su estado.
submit_time stringLa hora en que se envió la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringLa hora en que se ejecutó la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.end_time stringLa hora en que se completó la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.results object

Propiedades

video_url stringURL del video generado. Se devuelve solo cuando task_status es SUCCEEDED.Válido durante 24 horas. El video está en formato MP4 con codificación H.264.
code stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.
usage objectEstadísticas de salida. Solo se cuentan los resultados exitosos.

Propiedades

video_duration floatLa duración del video generado, en segundos.video_ratio stringEl modo de servicio utilizado para esta solicitud. Valores de enumeración: standard y pro.wan-std devuelve standard. wan-pro devuelve pro.
request_id stringIdentificador único de solicitud para rastreo y solución de problemas.
  • Tarea exitosa
  • Tarea fallida
Las URL de video son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde los videos generados de inmediato.
{
    "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"
    }
}

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:

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.