El modelo de texto a video Wan genera videos fluidos a partir de prompts de texto.
Referencias: Guía del usuario
Para garantizar llamadas exitosas, el modelo, la URL de Endpoint y la API Key deben pertenecer todos a la misma región. Las llamadas entre regiones fallarán.
Debido a que las tareas de texto a video tardan mucho tiempo (generalmente de 1 a 5 minutos), la API utiliza invocación asíncrona. Todo el proceso implica dos pasos principales: Crear una tarea -> Sondear el resultado. El proceso es el siguiente:
Los nombres de los parámetros en el SDK son mayormente consistentes con los de la API HTTP, y la estructura de parámetros está encapsulada para alinearse con las características del lenguaje de programación.
Dado que las tareas de texto a video pueden tardar mucho tiempo en completarse (generalmente de 1 a 5 minutos), el SDK encapsula el proceso de llamada asíncrona HTTP y admite métodos de invocación tanto síncronos como asíncronos.
Establezca
Establezca
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
R: No puede convertir el enlace directamente. El procedimiento correcto es hacer que su servicio backend recupere la URL, descargue el archivo de video y luego lo cargue en un servicio de almacenamiento de objetos permanente, como Alibaba Cloud Object Storage Service (OSS), para generar un nuevo enlace de acceso permanente.
R: No. No debe reproducir el enlace directamente en un navegador porque caduca después de 24 horas. En su lugar, debe descargar y almacenar el video, y luego utilizar un enlace permanente para su reproducción.
Disponibilidad
Para garantizar llamadas exitosas, el modelo, la URL de Endpoint y la API Key deben pertenecer todos a la misma región. Las llamadas entre regiones fallarán.
- Seleccionar un modelo: Confirm la región del modelo.
- Seleccionar una URL: Elija la URL de Endpoint regional correspondiente. Se admiten URLs HTTP y URLs del SDK de DashScope.
- Configurar una clave de API: Seleccione una región, obtenga una clave de API y luego configure la clave de API como variable de entorno (se desaprobará y se fusionará en la configuración de la clave de API).
- Instalar el SDK: Para realizar llamadas mediante el SDK, debe instalar el SDK de DashScope.
El código de ejemplo en este tema aplica a la región de Singapur.
HTTP
Debido a que las tareas de texto a video tardan mucho tiempo (generalmente de 1 a 5 minutos), la API utiliza invocación asíncrona. Todo el proceso implica dos pasos principales: Crear una tarea -> Sondear el resultado. El proceso es el siguiente:
Paso 1: Crear una tarea y obtener el ID de tarea
- Singapore
- Virginia
- Fráncfort
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisReemplace {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 solicitudEncabezados de solicitudContent-Typestring (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 solicitudmodelstring (Obligatorio)El nombre del modelo a utilizar. Para ver una lista de modelos disponibles, consulte la lista de modelos.Ejemplo: wan2.6-t2v.input object (Obligatorio)Contiene información básica de entrada, como el prompt.
Propiedades prompt string (Obligatorio)El prompt de texto. Describe los elementos deseados y las características visuales del video generado.El prompt puede estar en chino o en inglés. La longitud se mide en caracteres, donde cada carácter chino o letra cuenta como un carácter. El texto que supere el límite de caracteres se trunca automáticamente. El límite de longitud varía según la versión del modelo:
string (Opcional)Un prompt que describe el contenido a excluir del video. Esto ayuda a refinar el contenido generado.El prompt puede estar en chino o en inglés. La longitud máxima es de 500 caracteres. El texto que supere este límite se truncará automáticamente.Ejemplo: baja resolución, error, peor calidad, baja calidad, deformado, dedos adicionales, malas proporciones.audio_url string (Opcional)Modelos admitidos: modelos de las series wan2.6 y wan2.5.La URL del archivo de audio. El modelo utilizará este audio para generar el video.Formatos de entrada admitidos:
object (Opcional)Parámetros de procesamiento de video, como configurar la resolución del video, habilitar la reescritura de prompts y agregar una marca de agua.
Propiedades size string (Opcional)Especifica la resolución del video generado en formato width*height. El valor predeterminado y los valores válidos para este parámetro dependen del parámetro model, como se describe a continuación:
integer (Opcional)La duración del video generado en segundos. Los valores válidos para este parámetro dependen del parámetro model:
boolean (Opcional)Especifica si se debe habilitar la reescritura de prompts. Cuando está habilitada, un modelo reescribe inteligentemente el prompt de entrada. Esto mejora significativamente la calidad del video generado para prompts más cortos, pero aumenta el tiempo de ejecución.
string (Opcional)Modelos admitidos: Modelos wan2.6.Especifica el tipo de toma del video generado, es decir, si el video consiste en una sola toma continua o en múltiples tomas cambiantes.Valores válidos:
"prompt_extend": true.Prioridad de parámetros: shot_type > prompt. Por ejemplo, si shot_type se establece en "single", el modelo genera un video de una sola toma incluso si el prompt contiene "generar un video de múltiples tomas".watermark boolean (Opcional)Especifica si se debe agregar una marca de agua. La marca de agua se coloca en la esquina inferior derecha del video con el texto fijo "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 respuestaoutputobjectContiene la información de 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
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. |
Guarde el task_id para consultar el estado y el resultado de la tarea. |
Paso 2: Consultar el resultado por ID de tarea
- Singapore
- Virginia
- Fráncfort
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}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 comoUNKNOWN.
Parámetros de solicitudEncabezados de solicitudAuthorizationstring (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.Parámetros de ruta de URLtask_idstring (Obligatorio)El ID de la tarea. |
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. |
Parámetros de respuestaoutputobjectContiene la información de 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
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 devuelve el prompt optimizado 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.objectContiene estadísticas sobre la salida. Esta información se proporciona únicamente para tareas exitosas.
Propiedades video_duration integerSe devuelve solo cuando se utilizan modelos wan2.5 y anteriores. Se usa para facturación.La duración del video generado en segundos. Los valores válidos son 5 y 10.duration floatSe devuelve solo cuando se utiliza el modelo wan2.6. Se usa para facturación.Indica la duración total del video, donde duration = input_video_duration + output_video_duration.input_video_duration integerSe devuelve solo cuando se utiliza el modelo wan2.6. Fijo en 0.output_video_duration integerSe devuelve solo cuando se utiliza el modelo wan2.6.La duración del video de salida en segundos. Su valor es el mismo que el valor de input.duration.SR integerSe devuelve solo cuando se utiliza el modelo wan2.6. El nivel de resolución del video generado. Ejemplo: 720.size stringSe devuelve solo cuando se utiliza el modelo wan2.6. La resolución del video generado. El formato es "anchoalto". Ejemplo: 19201080.video_ratio stringSe devuelve solo cuando se utilizan modelos wan2.5 y anteriores. La resolución del video generado. El formato es "anchoalto". Ejemplo: 832480.video_count integerEl número de videos generados. Fijo en 1.stringIdentificador único de solicitud para rastreo y solución de problemas. |
Las URL de video son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde los videos generados de inmediato. |
SDK de DashScope
Los nombres de los parámetros en el SDK son mayormente consistentes con los de la API HTTP, y la estructura de parámetros está encapsulada para alinearse con las características del lenguaje de programación.
Dado que las tareas de texto a video pueden tardar mucho tiempo en completarse (generalmente de 1 a 5 minutos), el SDK encapsula el proceso de llamada asíncrona HTTP y admite métodos de invocación tanto síncronos como asíncronos.
El tiempo real de procesamiento depende del número de tareas en la cola y del estado del servicio. Espere el resultado.
Python
Establezca region según la región donde se encuentra el modelo (se pasa al construir el Client; el valor de region varía según la región):
- Singapore
- Virginia
- Beijing
- Fráncfort
region="ap-southeast-1"Reemplace {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 es válida durante 24 horas. Descárguela pronto.
Java
Establezca Constants.baseHttpApiUrl según la región donde se encuentra el modelo:
- Singapore
- Virginia
- Beijing
- Fráncfort
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Reemplace {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 es válida durante 24 horas. Descárguela pronto.
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: ¿Cómo convierto un enlace de video temporal en uno permanente?
R: No puede convertir el enlace directamente. El procedimiento correcto es hacer que su servicio backend recupere la URL, descargue el archivo de video y luego lo cargue en un servicio de almacenamiento de objetos permanente, como Alibaba Cloud Object Storage Service (OSS), para generar un nuevo enlace de acceso permanente.
Código de ejemplo: Descargar un video a un dispositivo local
Código de ejemplo: Descargar un video a un dispositivo local