Wanxiang - Imagen a video - Efectos de video

Este documento se aplica únicamente a la región China (Pekín). Para utilizar el modelo, debe usar una clave de API de la región China (Pekín).

Imagen del primer fotograma de entrada

Ejemplo de salida 1: Efecto "Levitación mágica"	Ejemplo de salida 2: Efecto "Compresión"
demo_flying.mp4	demo_squish.mp4
Valor de plantilla: flying	Valor de plantilla: squish

Uso

Alcance: Las plantillas de efectos de video solo son compatibles con las tareas de Wan Imagen a video (primer fotograma).
Método: En el cuerpo de la solicitud, establezca el parámetro template en el valor de plantilla deseado, como flying. Para ver todas las plantillas disponibles, consulte Plantillas de efectos de video.
Nota: Cuando utiliza el parámetro template, el modelo ignora el campo prompt. Puede omitir este campo o dejarlo vacío.

Enviar una solicitud

La API de imagen a video utiliza un flujo de trabajo asíncrono. Usted envía una tarea de generación de video y luego consulta el estado de la tarea para recuperar el resultado. Para conocer el flujo de trabajo completo, incluido cómo sondear el estado de la tarea y descargar el video generado, consulte la referencia de la API de imagen a video. El siguiente ejemplo muestra cómo enviar una solicitud de generación de video utilizando una plantilla de efectos de video:

curl
SDK de Python

# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-i2v-turbo",
    "input": {
        "img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png",
        "template": "flying"
    },
    "parameters": {
        "resolution": "720P"
    }
}'

import dashscope
import os
from dashscope.v2 import DashScopeError

# Si no se ha configurado la variable de entorno, sustituya la siguiente línea por su API Key de Model Studio: api_key="sk-xxx"
# Para obtener una clave de API, véase https://www.alibabacloud.com/help/model-studio/get-api-key
client = dashscope.Client(api_key=os.getenv("DASHSCOPE_API_KEY"), region="ap-southeast-1")

def sample_async_call():
    # Envía una tarea de generación de vídeo de forma asíncrona.
    # template (la plantilla de efecto de vídeo) es un campo de la sección input que no forma parte de la firma con nombre y se pasa mediante extra_input.
    try:
        job = client.videos.jobs.create(model='wanx2.1-i2v-turbo',
                                        image_url='https://cdn.translate.alibaba.com/r/wanx-demo-1.png',
                                        extra_input={'template': 'flying'},
                                        resolution='720P')
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"Código de estado HTTP: {e.status_code}")
        print(f"Código de error: {e.code}")
        print(f"Mensaje de error: {e.message}")
        print("Consulte la documentación: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
        return

    # Consulta el estado de la tarea.
    try:
        snapshot = client.videos.jobs.fetch(job.task_id)
        print(snapshot.status)
    except DashScopeError as e:
        print(f"Código de estado HTTP: {e.status_code}")
        print(f"Código de error: {e.code}")
        print(f"Mensaje de error: {e.message}")
        print("Consulte la documentación: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

    # Espera a que finalice la tarea.
    # (jobs.wait en la versión 2.0 usa sondeo con retroceso exponencial, con un presupuesto total predeterminado de 24 horas.)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"Código de estado HTTP: {e.status_code}")
        print(f"Código de error: {e.code}")
        print(f"Mensaje de error: {e.message}")
        print("Consulte la documentación: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_async_call()

Plantillas de efectos de video

Para obtener resultados óptimos, consulte la columna "Sugerencias de imagen de entrada" para cada plantilla.

Resumen de compatibilidad de modelos

Modelo	Plantillas compatibles
wanx2.1-i2v-plus	Todas las plantillas
wanx2.1-i2v-turbo	Efectos generales, Carrusel, Te quiero, Efectos para una persona o animales, Efectos para dos personas

Efectos generales

Todos los efectos generales son compatibles tanto con wanx2.1-i2v-plus como con wanx2.1-i2v-turbo. Estos efectos funcionan con cualquier entidad. Para obtener mejores resultados, utilice una imagen donde la entidad sea prominente y esté claramente diferenciada del fondo.

Nombre del efecto	Valor de plantilla	Efecto de ejemplo
Compresión	squish	squish.mp4
Giro	rotation	rotation.mp4
Toque	poke	poke.mp4
Inflado de globo	inflate	inflate.mp4
Difusión molecular	dissolve	dissolve.mp4

Efectos para una persona

Estos efectos funcionan con fotos de una sola persona. A menos que se indique lo contrario, se recomienda una foto frontal de medio cuerpo a cuerpo completo.

Nombre del efecto	Valor de plantilla	Modelos compatibles	Sugerencias de imagen de entrada	Efecto de ejemplo
Carrusel	carousel	wanx2.1-i2v-plus, wanx2.1-i2v-turbo	-	carousel.mp4
Te quiero	singleheart	wanx2.1-i2v-plus, wanx2.1-i2v-turbo	-	singleheart.mp4
Tiempo de swing	dance1	wanx2.1-i2v-plus	-	dance1.mp4
Baile swing	dance2	wanx2.1-i2v-plus	Se recomienda foto frontal de cuerpo entero	dance2.mp4
Swing estelar	dance3	wanx2.1-i2v-plus	Se recomienda foto frontal de cuerpo entero	dance3.mp4
Despertar sirena	mermaid	wanx2.1-i2v-plus	Se recomienda foto frontal de medio cuerpo	mermaid.mp4
Coronación académica	graduation	wanx2.1-i2v-plus	-	graduation.mp4
Persecución bestial	dragon	wanx2.1-i2v-plus	-	dragon.mp4
Dinero del cielo	money	wanx2.1-i2v-plus	-	money.mp4

Efectos para una persona o animales

Todos los efectos de esta categoría son compatibles con wanx2.1-i2v-plus y wanx2.1-i2v-turbo. Estos efectos funcionan con fotos de una sola persona o animales.

Nombre del efecto	Valor de plantilla	Sugerencias de imagen de entrada	Efecto de ejemplo
Levitación mágica	flying	Se recomienda foto frontal de cuerpo entero	flying.mp4
Rosa para ti	rose	Se recomienda foto frontal de medio cuerpo a cuerpo entero. Evite mostrar las manos.	rose.mp4
Rosa brillante	crystalrose	Se recomienda foto frontal de medio cuerpo a cuerpo entero. Evite mostrar las manos.	crystalrose.mp4

Efectos para dos personas

Todos los efectos de esta categoría son compatibles con wanx2.1-i2v-plus y wanx2.1-i2v-turbo. Estos efectos funcionan con fotos de dos personas. Se recomienda una foto de medio cuerpo o cuerpo completo en la que ambas personas miren a la cámara o se miren entre sí.

Nombre del efecto	Valor de plantilla	Efecto de ejemplo
Abrazo cariñoso	hug	hug.mp4
Interdependientes	frenchkiss	frenchkiss.mp4
Doble latido	coupleheart	coupleheart.mp4

Referencias

Para obtener descripciones de los parámetros de la API y ejemplos de código completos, consulte API de imagen a video.

​Uso

​Enviar una solicitud

​Plantillas de efectos de video

​Resumen de compatibilidad de modelos

​Efectos generales

​Efectos para una persona

​Efectos para una persona o animales

​Efectos para dos personas

​Referencias

Uso

Enviar una solicitud

Plantillas de efectos de video

Resumen de compatibilidad de modelos

Efectos generales

Efectos para una persona

Efectos para una persona o animales

Efectos para dos personas

Referencias