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. ImportanteSi falta este encabezado de solicitud, se devuelve el error "current user api does not support synchronous calls". Cuerpo de la solicitud Referencia de múltiples imágenesmodel string (Obligatorio) El nombre del modelo. Ejemplo: wan2.1-vace-plus. input object (Obligatorio) La entrada básica, como el prompt. Propiedades promptstring(Obligatorio) Describe los elementos y características visuales que se incluirán en el video generado. Admite tanto chino como inglés. La longitud máxima es de 800 caracteres, donde cada carácter chino o letra cuenta como un solo carácter. El texto que exceda este límite se truncará automáticamente. Para técnicas de prompts, consulte Guía de prompts de texto a video/imagen a video. functionstring(Obligatorio) Nombre de la función. La referencia de múltiples imágenes se establece en image_reference. La referencia de múltiples imágenes admite hasta 3 imágenes de referencia. Las imágenes pueden contener entidades y fondos, como personas, animales, ropa y escenas. Utilice un prompt para describir el contenido de video deseado, y el modelo podrá combinar las múltiples imágenes para generar contenido de video coherente. ref_images_urlarray[string] (Obligatorio) Una matriz de URLs de imágenes de referencia.
-
URL pública:
Puede proporcionar de 1 a 3 imágenes de referencia. Si proporciona más de 3, solo se utilizan las primeras 3. Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución: El ancho y el alto deben estar dentro del rango de [360, 2000] píxeles.
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
Recomendaciones:
- Al utilizar una imagen de referencia para una entidad, le recomendamos que cada imagen contenga solo una entidad. El fondo debe ser de un color sólido (por ejemplo, blanco) para resaltar mejor la entidad.
- Si utiliza un fondo de una imagen de referencia, puede proporcionar como máximo una imagen de fondo, la cual no debe contener ningún objeto de entidad.
| parameters object (Opcional) Parámetros para el procesamiento de video, como la configuración de marcas de agua. Propiedades obj_or_bg array[string] (Opcional) Este parámetro se utiliza para identificar el propósito de cada imagen de referencia y corresponde uno a uno con el parámetro ref_images_url. Cada elemento en la matriz especifica si la imagen en la posición correspondiente es un 'subject' o un 'background':
obj: Indica que la imagen es la entidad de referencia.bg: Especifica la imagen como referencia de fondo (se permite un máximo de una). Notas de uso:
- Le recomendamos que pase este parámetro, y su longitud debe ser la misma que la de
ref_images_url; de lo contrario, se reportará un error.
- Este parámetro puede omitirse y su valor predeterminado es
["obj"] solo si ref_images_url es una matriz de un solo elemento.
Ejemplo: ["obj", "obj", "bg"]. size string (Opcional) La resolución del video generado (ancho*alto). El modelo admite la generación de videos de 720p. Valores válidos:
1280*720 (Predeterminado): La relación de aspecto del video es 16:9, donde 1280 es el ancho y 720 es el alto.720*1280: La relación de aspecto del video es 9:16.960*960: La relación de aspecto del video es 1:1.832*1088: La relación de aspecto del video es 3:4.1088*832: La relación de aspecto del video es 4:3. duration integer (Opcional) La duración del video generado en segundos. Este valor está fijado en 5. prompt_extendbool (Opcional) Especifica si se debe habilitar la reescritura del prompt. Si está habilitado, un modelo de lenguaje grande (LLM) reescribe el prompt de entrada. Esto puede mejorar significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamiento.
true (predeterminado): Habilita la reescritura de prompts.false: Deshabilitar la reescritura de prompts. seedinteger(Opcional) La semilla de números aleatorios controla la aleatoriedad del contenido generado por el modelo. El rango de valores para el parámetro seed es [0, 2147483647]. Si no especifica una semilla, se genera una automáticamente. Para obtener resultados reproducibles, utilice el mismo valor de semilla en múltiples solicitudes. watermark bool(Opcional) Especifica si se debe agregar una marca de agua 'Generado por IA' en la esquina inferior derecha de la imagen.
false (predeterminado): No agrega una marca de agua.true: Agrega una marca de agua. |
Repintado de videomodel string (Obligatorio) El nombre del modelo. Ejemplo: wan2.1-vace-plus. input object (Obligatorio) La entrada básica, como el prompt. Propiedades promptstring(Obligatorio) Describe los elementos y características visuales que se incluirán en el video generado. Admite tanto chino como inglés. La longitud máxima es de 800 caracteres, donde cada carácter chino o letra cuenta como un solo carácter. El texto que exceda este límite se truncará automáticamente. Para técnicas de prompts, consulte Guía de prompts de texto a video/imagen a video. functionstring(Obligatorio) Nombre de la función. El repintado de video se establece en video_repainting. La función de repintado de video extrae la postura y las acciones de una entidad, la composición, los contornos de movimiento y la estructura de arte lineal de un video de entrada. Luego combina estos elementos con un indicador de texto para generar un nuevo video con las mismas características dinámicas. Esta función también admite el reemplazo de la entidad en el video original mediante una imagen de referencia, por ejemplo, para cambiar la apariencia de un personaje conservando las acciones originales. video_urlstring (Obligatorio) La URL del video de entrada.
-
URL pública:
Requisitos de video:
- Formato: MP4.
- Velocidad de fotogramas: 16 FPS o superior.
- Tamaño: Hasta 50 MB.
- Duración: Hasta 5 segundos. Los videos más largos se truncan a los primeros 5 segundos.
- La URL no debe contener caracteres chinos.
Resolución del video de salida:
- Si la resolución del video de entrada es 720p o inferior, la resolución de salida es la misma que la de entrada.
- Si la resolución del video de entrada es superior a 720p, se reduce para ajustarse a una resolución de 720p conservando la relación de aspecto original.
Duración del video de salida:
- La duración del video de salida coincide con la del video de entrada, hasta un máximo de 5 segundos.
- Ejemplo: Si el video de entrada tiene 3 segundos de duración, la salida también tendrá 3 segundos. Si la entrada tiene 6 segundos, la salida corresponde a los primeros 5 segundos de la entrada.
ref_images_urlarray[string] (Opcional) Una matriz de URLs de imágenes de referencia.
-
URL pública:
Solo se admite 1 imagen de referencia. Le recomendamos que esta imagen sea una imagen de entidad para reemplazar el contenido de la entidad en el video de entrada. Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución: El ancho y el alto deben estar dentro del rango de [360, 2000] píxeles.
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
Recomendaciones:
- Al utilizar una imagen de referencia para una entidad, le recomendamos que la imagen contenga solo una entidad. El fondo debe ser de un color sólido (por ejemplo, blanco) para resaltar mejor la entidad.
| parameters object (Obligatorio) Parámetros para el procesamiento de video, como la configuración de marcas de agua. Propiedades control_condition string (Obligatorio) El método para la extracción de características de video.
posebodyface: Extrae las expresiones faciales y los movimientos corporales de la entidad del video de entrada. Esto es adecuado para escenarios donde necesita preservar los detalles de las expresiones faciales de la entidad.posebody: Extrae los movimientos corporales de la entidad del video de entrada, excluyendo las expresiones faciales. Esto es adecuado para escenarios donde necesita controlar solo los movimientos corporales de la entidad.depth: Extrae la composición y los contornos de movimiento del video de entrada.scribble: Extrae la estructura de arte lineal del video de entrada. strength float (Opcional) Ajusta la fuerza de control del método de extracción de características de video especificado por control_condition sobre el video generado. El valor debe estar en el rango [0.0, 1.0]. El valor predeterminado es 1.0. Un valor mayor hace que el video generado se adhiera más estrechamente a las acciones y la composición del video original. Un valor menor permite mayor libertad creativa. prompt_extendbool (Opcional) Especifica si se debe habilitar la reescritura del prompt. Si está habilitado, un modelo de lenguaje grande (LLM) reescribe el prompt de entrada. Esto puede mejorar significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamiento.
true (predeterminado): Habilita la reescritura de prompts.false: Deshabilita la reescritura de prompts. (Recomendado)
Si la descripción de texto no coincide con el contenido del video, el modelo podría malinterpretar la entrada. Le recomendamos desactivar manualmente la expansión inteligente y proporcionar una descripción de escena clara y específica en el prompt para mejorar la consistencia y la precisión.
seedinteger(Opcional) La semilla de números aleatorios controla la aleatoriedad del contenido generado por el modelo. El rango de valores para el parámetro seed es [0, 2147483647]. Si no especifica una semilla, se genera una automáticamente. Para obtener resultados reproducibles, utilice el mismo valor de semilla en múltiples solicitudes. watermark bool(Opcional) Especifica si se debe agregar una marca de agua 'Generado por IA' en la esquina inferior derecha de la imagen.
false (predeterminado): No agrega una marca de agua.true: Agrega una marca de agua. |
Edición localmodel string (Obligatorio) El nombre del modelo. Ejemplo: wan2.1-vace-plus. input object (Obligatorio) La entrada básica, como el prompt. Propiedades promptstring(Obligatorio) Describe los elementos y características visuales que se incluirán en el video generado. Admite tanto chino como inglés. La longitud máxima es de 800 caracteres, donde cada carácter chino o letra cuenta como un solo carácter. El texto que exceda este límite se truncará automáticamente. Para técnicas de prompts, consulte Guía de prompts de texto a video/imagen a video. functionstring(Obligatorio) Nombre de la función: La edición local se establece en video_edit. La función de edición local le permite agregar, modificar o eliminar elementos en un área específica de un video de entrada. También puede reemplazar la entidad o el fondo en el área de edición para lograr una edición de video detallada. video_urlstring (Obligatorio) La URL del video de entrada.
-
URL pública:
Requisitos de video:
- Formato: MP4.
- Velocidad de fotogramas: 16 FPS o superior.
- Tamaño: Hasta 50 MB.
- Duración: Hasta 5 segundos. Los videos más largos se truncan a los primeros 5 segundos.
- La URL no debe contener caracteres chinos.
Resolución del video de salida:
- Si la resolución del video de entrada es 720p o inferior, la resolución de salida es la misma que la de entrada.
- Si la resolución del video de entrada es superior a 720p, se reduce para ajustarse a una resolución de 720p conservando la relación de aspecto original.
Duración del video de salida:
- La duración del video de salida coincide con la del video de entrada, hasta un máximo de 5 segundos.
- Ejemplo: Si el video de entrada tiene 3 segundos de duración, la salida también tendrá 3 segundos. Si la entrada tiene 6 segundos, la salida corresponde a los primeros 5 segundos de la entrada.
ref_images_urlarray[string] (Opcional) Una matriz de URLs de imágenes de referencia.
-
URL pública:
Actualmente, solo se admite 1 imagen de referencia. Esta imagen puede utilizarse como entidad o fondo para reemplazar el contenido correspondiente en el video de entrada. Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución: El ancho y el alto deben estar dentro del rango de [360, 2000] píxeles.
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
Recomendaciones:
- Al utilizar una imagen de referencia para una entidad, le recomendamos que la imagen contenga solo una entidad. El fondo debe ser de un color sólido (por ejemplo, blanco) para resaltar mejor la entidad.
- Si utiliza un fondo de una imagen de referencia, la imagen de fondo no debe contener ningún objeto de entidad.
mask_image_urlstring (Opcional) La URL de la imagen de máscara.
-
URL pública:
Este parámetro especifica el área de edición del video. Puede especificar este parámetro o el parámetro mask_video_url. Le recomendamos que priorice este parámetro. En la imagen de máscara, las áreas blancas (valor de píxel [255, 255, 255]) definen la región a editar, mientras que las áreas negras (valor de píxel [0, 0, 0]) definen la región a conservar. Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución de la imagen: Debe ser la misma que la resolución del video de entrada (
video_url).
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
mask_frame_idinteger (Opcional) Este parámetro surte efecto cuando mask_image_url no está vacío. Especifica el ID del fotograma en el video donde aparece el objetivo de la máscara. El valor predeterminado es 1, que indica el primer fotograma del video. El rango de valores es [1, max_frame_id], donde max_frame_id = input video frame rate * input video duration + 1.
Por ejemplo, si un video de entrada (video_url) tiene una tasa de fotogramas de 16 FPS (fotogramas por segundo) y una duración de 5 segundos, el número total de fotogramas es 16 × 5 + 1 = 81. Por lo tanto, max_frame_id = 81.
mask_video_urlstring (Opcional) La URL del video de máscara.
-
URL pública:
Este parámetro se utiliza para especificar el área de edición del video. Debe especificar este parámetro o el parámetro mask_image_url. El formato de video, la tasa de fotogramas, la resolución y la duración del video de máscara deben ser idénticos a los del video de entrada (video_url). En el video de máscara, las áreas blancas (valor de píxel [255, 255, 255]) definen la región a editar, mientras que las áreas negras (valor de píxel [0, 0, 0]) definen la región a conservar. | parameters object (Opcional) Parámetros para el procesamiento de video, como la configuración de marcas de agua. Propiedades control_condition string (Opcional) El método para la extracción de características de video. El valor predeterminado es "", lo que significa que no se extraen características.
posebodyface: Extrae las expresiones faciales y los movimientos corporales de la entidad del video de entrada. Esto es adecuado para escenarios donde el rostro de la entidad ocupa una gran parte del encuadre y sus rasgos son claramente visibles.depth: Extrae la composición y los contornos de movimiento del video de entrada. mask_type string (Opcional) Cuando mask_image_url no está vacío, este parámetro surte efecto para especificar el comportamiento del área de edición.
tracking (Predeterminado): El área de edición sigue dinámicamente la trayectoria de movimiento del objeto objetivo. Esto es adecuado para escenarios donde el sujeto se está moviendo.fixed: El área de edición permanece fija y no cambia con el contenido de la pantalla. expand_ratio float (Opcional) Cuando mask_type es tracking, este parámetro surte efecto y especifica la proporción para expandir el área de máscara hacia afuera. El valor debe estar en el rango [0.0, 1.0]. El valor predeterminado es 0.05, que es el recomendado. Un valor más pequeño hace que el área de máscara se ajuste más al objeto objetivo, mientras que un valor más grande expande el área de máscara más ampliamente. expand_mode string (Opcional) Cuando mask_type es tracking, este parámetro surte efecto y especifica la forma del área de máscara. El algoritmo genera un video de máscara con la forma correspondiente a partir de la imagen de máscara de entrada, basándose en el expand_mode seleccionado. Los valores admitidos son los siguientes:
hull (Predeterminado): El modo de polígono. Este modo utiliza un polígono para encerrar el objeto enmascarado.bbox: Modo de cuadro delimitador. Este modo utiliza un rectángulo para encerrar el objeto enmascarado.original: El modo original, que intenta preservar la forma del objetivo de máscara original. size string (Opcional) La resolución del video generado (ancho*alto). El modelo admite la generación de videos de 720p. Valores válidos:
1280*720 (Predeterminado): La relación de aspecto del video es 16:9, donde 1280 es el ancho y 720 es el alto.720*1280: La relación de aspecto del video es 9:16.960*960: La relación de aspecto del video es 1:1.832*1088: La relación de aspecto del video es 3:4.1088*832: La relación de aspecto del video es 4:3. duration integer (Opcional) La duración del video generado en segundos. Este valor está fijado en 5. prompt_extendbool (Opcional) Especifica si se debe habilitar la reescritura del prompt. Si está habilitado, un modelo de lenguaje grande (LLM) reescribe el prompt de entrada. Esto puede mejorar significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamiento.
true (predeterminado): Habilita la reescritura de prompts.false: Deshabilita la reescritura de prompts. (Recomendado)
Si la descripción de texto no coincide con el contenido del video, el modelo podría malinterpretar la entrada. Le recomendamos desactivar manualmente la expansión inteligente y proporcionar una descripción de escena clara y específica en el prompt para mejorar la consistencia y la precisión.
seedinteger(Opcional) La semilla de números aleatorios controla la aleatoriedad del contenido generado por el modelo. El rango de valores para el parámetro seed es [0, 2147483647]. Si no especifica una semilla, se genera una automáticamente. Para obtener resultados reproducibles, utilice el mismo valor de semilla en múltiples solicitudes. watermark bool(Opcional) Especifica si se debe agregar una marca de agua 'Generado por IA' en la esquina inferior derecha de la imagen.
false (predeterminado): No agrega una marca de agua.true: Agrega una marca de agua. |
Extensión de videomodel string (Obligatorio) El nombre del modelo. Ejemplo: wan2.1-vace-plus. input object (Obligatorio) La entrada básica, como el prompt. Propiedades promptstring(Obligatorio) Describe los elementos y características visuales que se incluirán en el video generado. Admite tanto chino como inglés. La longitud máxima es de 800 caracteres, donde cada carácter chino o letra cuenta como un solo carácter. El texto que exceda este límite se truncará automáticamente. Para técnicas de prompts, consulte Guía de prompts de texto a video/imagen a video. functionstring(Obligatorio) Nombre de la función. La extensión de video se establece en video_extension. La función de extensión de video genera contenido continuo a partir de una imagen o video. También puede extraer características dinámicas, como acciones y composición, de un video de referencia para guiar la generación de un video con movimiento similar.
La duración total del video generado es de 5 segundos. Esta es la duración final de salida, no una extensión de 5 segundos añadida al contenido original.
first_frame_urlstring (Opcional) La URL de la imagen del primer fotograma.
-
URL pública:
Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución: El ancho y el alto deben estar dentro del rango de [360, 2000] píxeles.
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
last_frame_urlstring(Opcional) La URL de la imagen del último fotograma.
-
URL pública:
Requisitos de imagen:
- Formato: JPG, JPEG, PNG, BMP, TIFF o WEBP.
- Resolución: El ancho y el alto deben estar dentro del rango de [360, 2000] píxeles.
- Tamaño: Hasta 10 MB.
- La URL no debe contener caracteres chinos.
first_clip_urlstring (Opcional) La URL del primer clip de video.
-
URL pública:
Requisitos de video:
- Formato: MP4.
- Tasa de fotogramas del video: Mayor o igual a 16 FPS. Cuando
first_clip_url y last_clip_url se utilizan juntos, le recomendamos que ambos clips tengan la misma tasa de fotogramas.
- Tamaño: Hasta 50 MB.
- Longitud del video: El video no puede durar más de 3 segundos. De lo contrario, se utilizarán los primeros 3 segundos del video. Si especifica tanto
first_clip_url como last_clip_url, la duración total de los dos clips de video no puede exceder 3 segundos.
- La URL no debe contener caracteres chinos.
Resolución del video de salida:
- Si la resolución del video de entrada es 720p o inferior, la resolución de salida es la misma que la de entrada.
- Si la resolución del video de entrada es superior a 720p, se reduce para ajustarse a una resolución de 720p conservando la relación de aspecto original.
last_clip_urlstring(Opcional) La URL del último clip de video.
-
URL pública:
Requisitos de video:
- Formato: MP4.
- Tasa de fotogramas del video: 16 FPS o superior. Cuando
first_clip_url y last_clip_url se utilizan juntos, le recomendamos que ambos clips tengan la misma tasa de fotogramas.
- Tamaño: Hasta 50 MB.
- Duración del video: La duración no puede exceder 3 segundos. Si un video es más largo, solo se utilizan los primeros 3 segundos. Si especifica tanto
first_clip_url como last_clip_url, su duración combinada no puede exceder 3 segundos.
- La URL no debe contener caracteres chinos.
Resolución del video de salida:
- Si la resolución del video de entrada es 720p o inferior, la resolución de salida es la misma que la de entrada.
- Si la resolución del video de entrada es superior a 720p, se reduce para ajustarse a una resolución de 720p conservando la relación de aspecto original.
video_urlstring (Opcional) La URL del video de entrada.
-
URL pública:
Este video se utiliza principalmente para extraer características de movimiento que funcionan en conjunto con los parámetros first_frame_url, last_frame_url, first_clip_url y last_clip_url para guiar la generación de un video extendido con un rendimiento de movimiento similar. Requisitos de video:
- Formato: MP4.
- Tasa de fotogramas: 16 FPS o superior, coincidente con los clips anteriores y posteriores.
- Resolución: Coincidente con los fotogramas y clips anteriores y posteriores.
- Tamaño: Hasta 50 MB.
- Duración: Hasta 5 segundos. Los videos más largos se truncan a los primeros 5 segundos.
- La URL no debe contener caracteres chinos.
| parameters object (Opcional) Parámetros para el procesamiento de video, como la configuración de la resolución del video de salida. Propiedades control_condition string (Opcional) El método para la extracción de características de video. Este parámetro es obligatorio cuando se especifica video_url. El valor predeterminado es "", lo que significa que no se extraen características.
posebodyface: Extrae las expresiones faciales y los movimientos corporales de la entidad en el video de entrada.depth: Extrae la composición y los contornos de movimiento del video de entrada. duration integer (Opcional) La duración del video generado en segundos. Este valor está fijado en 5. prompt_extendbool (Opcional) Especifica si se debe habilitar la reescritura del prompt. Si está habilitado, un modelo de lenguaje grande (LLM) reescribe el prompt de entrada. Esto puede mejorar significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamiento.
true (predeterminado): Habilita la reescritura de prompts.false: Deshabilita la reescritura de prompts. (Recomendado)
Si la descripción de texto no coincide con el contenido del video, el modelo podría malinterpretar la entrada. Le recomendamos desactivar manualmente la expansión inteligente y proporcionar una descripción de escena clara y específica en el prompt para mejorar la consistencia y la precisión.
seedinteger(Opcional) La semilla de números aleatorios controla la aleatoriedad del contenido generado por el modelo. El rango de valores para el parámetro seed es [0, 2147483647]. Si no especifica una semilla, se genera una automáticamente. Para obtener resultados reproducibles, utilice el mismo valor de semilla en múltiples solicitudes. watermark bool(Opcional) Especifica si se debe agregar una marca de agua 'Generado por IA' en la esquina inferior derecha de la imagen.
false (predeterminado): No agrega una marca de agua.true: Agrega una marca de agua. |
Expansión de videomodel string (Obligatorio) El nombre del modelo. Ejemplo: wan2.1-vace-plus. input object (Obligatorio) La entrada básica, como el prompt. Propiedades promptstring(Obligatorio) Describe los elementos y características visuales que se incluirán en el video generado. Admite tanto chino como inglés. La longitud máxima es de 800 caracteres, donde cada carácter chino o letra cuenta como un solo carácter. El texto que exceda este límite se truncará automáticamente. Para técnicas de prompts, consulte Guía de prompts de texto a video/imagen a video. functionstring(Obligatorio) Nombre de la función. El valor para la expansión de video es video_outpainting. La función de expansión de video extiende el fotograma de video proporcionalmente en las direcciones superior, inferior, izquierda y derecha. video_urlstring (Obligatorio) La URL del video de entrada.
-
URL pública:
Requisitos de video:
- Formato: MP4.
- Velocidad de fotogramas: 16 FPS o superior.
- Tamaño: Hasta 50 MB.
- Duración: Hasta 5 segundos. Los videos más largos se truncan a los primeros 5 segundos.
- La URL no debe contener caracteres chinos.
Resolución del video de salida:
- Si la resolución del video de entrada es 720p o inferior, la resolución de salida es la misma que la de entrada.
- Si la resolución del video de entrada es superior a 720p, se reduce para ajustarse a una resolución de 720p conservando la relación de aspecto original.
Duración del video de salida:
- La duración del video de salida coincide con la del video de entrada, hasta un máximo de 5 segundos.
- Ejemplo: Si el video de entrada tiene 3 segundos de duración, la salida también tendrá 3 segundos. Si la entrada tiene 6 segundos, la salida corresponde a los primeros 5 segundos de la entrada.
| parameters object (Opcional) Parámetros para el procesamiento de video, como la configuración de relaciones de extensión. Propiedades top_scale float (Opcional) Centra el fotograma del video y lo extiende hacia arriba según la relación especificada. El valor debe estar en el rango [1.0, 2.0]. El valor predeterminado es 1.0, que indica que no hay extensión. bottom_scale float (Opcional) Centra el fotograma del video y lo extiende hacia abajo según la relación especificada. El valor debe estar en el rango [1.0, 2.0]. El valor predeterminado es 1.0, que indica que no hay extensión. left_scale float (Opcional) Centra el fotograma de video y lo extiende hacia la izquierda según la proporción especificada. El valor debe estar en el rango [1.0, 2.0]. El valor predeterminado es 1.0, que indica que no hay extensión. right_scale float (Opcional) Centra el fotograma de video y lo extiende hacia la derecha según la proporción especificada. El valor debe estar en el rango [1.0, 2.0]. El valor predeterminado es 1.0, que indica que no hay extensión. duration integer (Opcional) La duración del video generado en segundos. Este valor está fijado en 5. prompt_extendbool (Opcional) Especifica si se debe habilitar la reescritura del prompt. Si está habilitado, un modelo de lenguaje grande (LLM) reescribe el prompt de entrada. Esto puede mejorar significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamiento.
true (predeterminado): Habilita la reescritura de prompts.false: Deshabilita la reescritura de prompts. (Recomendado)
Si la descripción de texto no coincide con el contenido del video, el modelo podría malinterpretar la entrada. Le recomendamos desactivar manualmente la expansión inteligente y proporcionar una descripción de escena clara y específica en el prompt para mejorar la consistencia y la precisión.
seedinteger(Opcional) La semilla de números aleatorios controla la aleatoriedad del contenido generado por el modelo. El rango de valores para el parámetro seed es [0, 2147483647]. Si no especifica una semilla, se genera una automáticamente. Para obtener resultados reproducibles, utilice el mismo valor de semilla en múltiples solicitudes. watermark bool(Opcional) Especifica si se debe agregar una marca de agua 'Generado por IA' en la esquina inferior derecha de la imagen.
false (predeterminado): No agrega una marca de agua.true: Agrega una marca de agua. |
| Referencia de múltiples imágenes
Las claves de API para las regiones de Singapore y China (Beijing) son diferentes. Obtener una clave de API
La siguiente URL corresponde a la región de Singapur. Para la región de China (Beijing), utilice esta URL en su lugar: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "image_reference",
"prompt": "In the video, a girl gracefully emerges from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops to look at the lush woods around her, a smile of surprise and joy blossoms on her face. This scene, frozen in an interplay of light and shadow, records her wonderful encounter with nature.",
"ref_images_url": [
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
},
"parameters": {
"prompt_extend": true,
"obj_or_bg": ["obj","bg"],
"size": "1280*720"
}
}'
Repintado de video
Las claves de API para las regiones de Singapore y China (Beijing) son diferentes. Obtener una clave de API
La siguiente URL corresponde a la región de Singapur. Para la región de China (Beijing), utilice esta URL en su lugar: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_repainting",
"prompt": "The video shows a black steampunk-style car driven by a gentleman, adorned with gears and copper pipes. The background is a steam-powered candy factory with retro elements, creating a vintage and fun scene.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"control_condition": "depth"
}
}'
Edición local
Las claves de API para las regiones de Singapore y China (Beijing) son diferentes. Obtener una clave de API
La siguiente URL corresponde a la región de Singapur. Para la región de China (Beijing), utilice esta URL en su lugar: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_edit",
"prompt": "The video shows a Parisian-style French cafe where a lion in a suit elegantly sips coffee. It holds a coffee cup in one hand, taking a gentle sip with a relaxed expression. The cafe is tastefully decorated, with soft hues and warm lighting illuminating the lion's area.",
"mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
"video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
"mask_frame_id": 1
},
"parameters": {
"prompt_extend": false,
"mask_type": "tracking",
"expand_ratio": 0.05
}
}'
Extensión de video
Las claves de API para las regiones de Singapore y China (Beijing) son diferentes. Obtener una clave de API
La siguiente URL corresponde a la región de Singapur. Para la región de China (Beijing), utilice esta URL en su lugar: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_extension",
"prompt": "A dog wearing sunglasses skateboarding on the street, 3D cartoon.",
"first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
},
"parameters": {
"prompt_extend": false
}
}'
Expansión de video
Las claves de API para las regiones de Singapore y China (Beijing) son diferentes. Obtener una clave de API
La siguiente URL corresponde a la región de Singapur. Para la región de China (Beijing), utilice esta URL en su lugar: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_outpainting",
"prompt": "An elegant woman passionately plays the violin, with a full symphony orchestra behind her.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"top_scale": 1.5,
"bottom_scale": 1.5,
"left_scale": 1.5,
"right_scale": 1.5
}
}'
|
