El modelo de texto a video Wan genera videos fluidos a partir de prompts de texto.
Referencias: Guía del usuario
Coincida la región de su modelo, URL de endpoint y clave de API. Las llamadas entre regiones fallarán.
Las tareas de texto a video tardan entre 1 y 5 minutos. La API utiliza invocación asíncrona: Crear una tarea → Sondear el resultado.
Reemplace
Reemplace
Las tareas de texto a video tardan entre 1 y 5 minutos, por lo que la API utiliza invocación asíncrona: Crear una tarea → Sondear el resultado.
Reemplace
Reemplace
Los nombres de los parámetros del SDK coinciden en su mayoría con los de la API HTTP, con estructuras que siguen las convenciones específicas del lenguaje.
Las tareas de texto a video tardan entre 1 y 5 minutos. El SDK encapsula el flujo de llamadas HTTP asíncronas y admite tanto la invocación síncrona como la asíncrona.
Establezca region según la región del modelo (se pasa al construir el Client; el valor de region varía según la región):
Reemplace
Establezca Constants.baseHttpApiUrl en el endpoint de la región:
Reemplace
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
R: Se requieren dos cambios:
R: La conversión directa no es posible. Descargue el video desde la URL y luego súbalos a un almacenamiento persistente (como Alibaba Cloud OSS) para generar un enlace permanente.
R: No. El enlace caduca después de 24 horas. Descargue el video, almacénelo de forma persistente y utilice un enlace permanente para su reproducción.
Disponibilidad
Coincida la región de su modelo, URL de endpoint y clave de API. Las llamadas entre regiones fallarán.
- Seleccionar un modelo: Vaya a Model Gallery para seleccionar un modelo y verificar su región.
- Seleccionar una URL: Utilice la URL de endpoint correspondiente a la región. Se admiten tanto HTTP como HTTPS.
- Configurar una clave de API: Seleccione una región, obtenga una clave de API y configúrela en variables de entorno.
- Instalar el SDK: Para llamar a la API mediante un SDK, instale el SDK de DashScope.
El código de ejemplo en este tema utiliza la región de Singapur.
HTTP (wan2.7)
Las tareas de texto a video tardan entre 1 y 5 minutos. La API utiliza invocación asíncrona: Crear una tarea → Sondear el resultado.
Paso 1: Crear una tarea
- Beijing
- Singapore
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} con su ID de espacio de trabajo real.
- Después de crear la tarea, utilice el
task_iddevuelto para consultar el resultado. Eltask_ides 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 |
Controle la estructura de tomas con lenguaje natural en el prompt. El parámetro shot_type no tiene efecto.
| ||||||||||||||||||||||||
Encabezados | |||||||||||||||||||||||||
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. | |||||||||||||||||||||||||
Cuerpo de la solicitud | |||||||||||||||||||||||||
model string (Obligatorio)Nombre del modelo. Para modelos y precios, consulte Precios de modelos.Ejemplo: wan2.7-t2v, wan2.7-t2v-2026-06-12. | |||||||||||||||||||||||||
input object (Obligatorio)Datos de entrada, incluido el prompt.
Propiedades prompt string (Obligatorio)Prompt de texto que describe el contenido del video y el estilo visual.Admite chino e inglés. Cada carácter o letra cuenta como uno. El texto que exceda el límite se trunca automáticamente. Longitud máxima según el modelo:
string (Opcional)Elementos a excluir del video generado.Admite chino e inglés. Máximo de 500 caracteres; el texto más largo se trunca automáticamente.Ejemplo: baja resolución, error, peor calidad, baja calidad, deformado, dedos adicionales, malas proporciones.audio_url string (Opcional)URL del archivo de audio para la generación de video.Formatos admitidos:
| |||||||||||||||||||||||||
parameters object (Opcional)Parámetros de generación de video: resolución, reescritura de prompts y marca de agua.
Propiedades resolution string (Opcional)Nivel de resolución del video generado. Controla la claridad de salida (recuento total de píxeles).
string (Opcional)Relación de aspecto del video de salida.
integer (Opcional)Duración del video de salida, en segundos.
boolean (Opcional)Habilita la reescritura de prompts. Cuando está habilitado, un LLM reescribe el prompt de entrada para mejorar la calidad de generación. Es ideal para prompts cortos, pero añade latencia.
boolean (Opcional)Añade una marca de agua en la esquina inferior derecha con el texto "AI Generated".
integer (Opcional)La semilla de número aleatorio debe ser un entero en el rango [0, 2147483647].Si no se especifica, se genera una semilla aleatoria. Una semilla fija mejora la reproducibilidad.Dado que la generación del modelo es probabilística, la misma semilla no garantiza resultados idénticos. |
Parámetros de respuesta |
Guarde el task_id para consultar el estado y el resultado de la tarea. |
output objectSalida 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
| |
request_id stringIdentificador único de solicitud para rastreo y solución de problemas. | |
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. |
Paso 2: Consultar el resultado
- Beijing
- Singapore
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{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 comoUNKNOWN.
Parámetros de solicitud |
Reemplace {task_id} con el valor task_id devuelto por la llamada a la API anterior. El task_id es válido para consultas durante 24 horas. Reemplace {WorkspaceId} con su ID de espacio de trabajo real. |
Encabezados | |
Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx. | |
Parámetros de ruta | |
task_id string (Obligatorio)El ID de la tarea. |
Parámetros de respuesta |
Las URL de video son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde los videos generados de inmediato. |
outputobjectSalida 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
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.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.orig_prompt stringEl prompt de entrada original, correspondiente al parámetro de solicitud prompt.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. Se devuelven solo para tareas exitosas.
Propiedades duration floatDuración total del video, utilizada para facturación.Igual a output_video_duration.input_video_duration integerValor fijo: 0.output_video_duration integerDuración del video de salida en segundos. Coincide con el valor de input.duration.SR integerNivel de resolución del video de salida. Ejemplo: 720.ratio stringRelación de aspecto del video de salida. Ejemplo: 16:9.video_count integerNúmero de videos generados. Siempre 1. | |
request_id stringIdentificador único de solicitud para rastreo y solución de problemas. |
HTTP (wan2.6 y anteriores)
Las tareas de texto a video tardan entre 1 y 5 minutos, por lo que la API utiliza invocación asíncrona: Crear una tarea → Sondear el resultado.
Paso 1: Crear una tarea
- Singapore
- Virginia
- Beijing
- Fráncfort
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} con su ID de espacio de trabajo real.
- Después de crear la tarea, utilice el
task_iddevuelto para consultar el resultado. Eltask_ides 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. | |
Cuerpo de la solicitud | |
model string (Obligatorio)Nombre del modelo. Para modelos y precios, consulte Precios de modelos.Ejemplo: wan2.6-t2v. | |
input object (Obligatorio)Datos de entrada, incluido el prompt.
Propiedades prompt string (Obligatorio)Prompt de texto que describe el contenido del video y el estilo visual.Admite chino e inglés. Cada carácter o letra cuenta como uno. El texto que exceda el límite se trunca automáticamente. Longitud máxima según el modelo:
string (Opcional)Elementos a excluir del video generado.Admite chino e inglés. Máximo de 500 caracteres; el texto más largo se trunca automáticamente.Ejemplo: baja resolución, error, peor calidad, baja calidad, desfigurado, dedos extra, malas proporciones.audio_url string (Opcional)Modelos compatibles: series wan2.6 y wan2.5.URL del archivo de audio para la generación de video.Formatos admitidos:
| |
parameters object (Opcional)Parámetros de generación de video: resolución, reescritura de prompts y marca de agua.
Propiedades size string (Opcional)Resolución del video de salida en formato width*height. Los valores predeterminados y válidos dependen del modelo:
integer (Opcional)Duración del video de salida en segundos. Los valores válidos dependen del modelo:
boolean (Opcional)Habilita la reescritura de prompts. Cuando está habilitado, un LLM reescribe el prompt de entrada para mejorar la calidad. Es ideal para prompts cortos, pero añade latencia.
string (Opcional)Modelos admitidos: Modelos wan2.6.Estructura de tomas para el video de salida: una toma continua o múltiples tomas con transiciones.Valores válidos:
"prompt_extend": true.Prioridad: shot_type anula el prompt. Establecer shot_type en single produce un video de una sola toma incluso si el prompt solicita múltiples tomas.watermark boolean (Opcional)Añade una marca de agua en la esquina inferior derecha con el texto "AI Generated".
integer (Opcional)La semilla de número aleatorio debe ser un entero en el rango [0, 2147483647].Si no se especifica, se genera una semilla aleatoria. Una semilla fija mejora la reproducibilidad.Dado que la generación del modelo es probabilística, la misma semilla no garantiza resultados idénticos. |
Parámetros de respuesta |
Guarde el task_id para consultar el estado y el resultado de la tarea. |
output objectSalida 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
| |
request_id stringIdentificador único de solicitud para rastreo y solución de problemas. | |
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. |
Paso 2: Consultar el resultado
- Singapore
- Virginia
- Beijing
- Fráncfort
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{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 comoUNKNOWN.
Parámetros de solicitud |
Reemplace {task_id} con el valor task_id devuelto por la llamada a la API anterior. El task_id es válido para consultas durante 24 horas. Reemplace {WorkspaceId} con su ID de espacio de trabajo real. |
Encabezados | |
Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx. | |
Parámetros de ruta | |
task_id string (Obligatorio)El ID de la tarea. |
Parámetros de respuesta |
Las URL de video son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde los videos generados de inmediato. |
outputobjectSalida 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
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.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.orig_prompt stringEl prompt de entrada original, correspondiente al parámetro de solicitud prompt.actual_prompt stringCuando prompt_extend=true, el sistema reescribe el prompt de entrada. Este campo contiene el prompt reescrito utilizado para la generación.
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. Se devuelven solo para tareas exitosas.
Propiedades video_duration integerSe devuelve solo para wan2.5 y anteriores (utilizado para facturación).Duración del video de salida en segundos. Valores válidos: 5, 10.duration floatSe devuelve solo para wan2.6 (utilizado para facturación).Duración total del video. Fórmula: duration=input_video_duration+output_video_duration.input_video_duration integerSe devuelve solo para wan2.6. Valor fijo: 0.output_video_duration integerSe devuelve solo para wan2.6.Duración del video de salida en segundos. Coincide con el valor de input.duration.SR integerSe devuelve solo para wan2.6. Nivel de resolución del video de salida. Ejemplo: 720.size stringSe devuelve solo para wan2.6. Resolución de salida en formato "ancho×alto". Ejemplo: 1920×1080.video_ratio stringSe devuelve solo para wan2.5 y anteriores. Resolución de salida en formato "ancho×alto". Ejemplo: 832×480.video_count integerNúmero de videos generados. Siempre 1. | |
request_id stringIdentificador único de solicitud para rastreo y solución de problemas. |
SDK de DashScope
Los nombres de los parámetros del SDK coinciden en su mayoría con los de la API HTTP, con estructuras que siguen las convenciones específicas del lenguaje.
Las tareas de texto a video tardan entre 1 y 5 minutos. El SDK encapsula el flujo de llamadas HTTP asíncronas y admite tanto la invocación síncrona como la asíncrona.
El tiempo real de procesamiento depende de la profundidad de la cola y la carga del servicio.
SDK de Python
Establezca region según la región del modelo (se pasa al construir el Client; el valor de region varía según la región):
- Beijing
- Singapore
- Virginia
region="cn-beijing"{WorkspaceId} con su ID de espacio de trabajo real.
- Invocación síncrona
- Invocación asíncrona
Ejemplo de solicitud
Ejemplo de respuesta
La video_url caduca después de 24 horas. Descárguela pronto.
SDK de Java
Establezca Constants.baseHttpApiUrl en el endpoint de la región:
- Singapore
- Virginia
- Beijing
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} con su ID de espacio de trabajo real.
- Invocación síncrona
- Invocación asíncrona
Ejemplo de solicitud
Ejemplo de respuesta
La video_url caduca después de 24 horas. Descárguela pronto.
Limitaciones
- Retención de datos: El ID de tarea (
task_id) y la URL del video (video_url) caducan después de 24 horas. Tras la caducidad, no se pueden consultar ni descargar. - Moderación de contenido: La entrada y la salida pasan por moderación de contenido. El contenido prohibido activa errores "IPInfringementSuspect" o "DataInspectionFailed". Consulte Códigos de error.
Códigos de error
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
FAQ
P: ¿Qué cambios de código se necesitan para actualizar de wan2.6 a wan2.7?
R: Se requieren dos cambios:
- Control de resolución: wan2.7 reemplaza el campo
size. En su lugar, utiliza una combinación deresolution(nivel de resolución) yratio(relación de aspecto) para definir la resolución de salida. Los modelos anteriores utilizaban el camposize. - Eliminación del tipo de toma: wan2.7 elimina el campo
shot_type. Describa la estructura de las tomas directamente en el prompt.
P: ¿Cómo convierto un enlace de video temporal en uno permanente?
R: La conversión directa no es posible. Descargue el video desde la URL y luego súbalos a un almacenamiento persistente (como Alibaba Cloud OSS) para generar un enlace permanente.
Código de ejemplo: Descargar un video a un dispositivo local
Código de ejemplo: Descargar un video a un dispositivo local