El modelo de referencia a video de Wan acepta entradas multimodales y genera videos de un solo personaje o de interacción entre múltiples personajes utilizando personas u objetos como protagonistas.
Véase también: Guía del usuario
El modelo, la URL del endpoint y la clave de API deben pertenecer a la misma región. Las llamadas entre regiones fallarán.
Las tareas de generación de video suelen tardar entre 1 y 5 minutos. La API utiliza llamadas asíncronas con dos pasos: "crear una tarea -> sondear el resultado". Los detalles son los siguientes:
Los parámetros del SDK siguen las mismas convenciones de nomenclatura que la API HTTP, con encapsulamientos específicos para cada lenguaje.
Las tareas de referencia a video suelen tardar entre 1 y 5 minutos. El SDK encapsula el flujo de trabajo asíncrono HTTP y admite llamadas síncronas y asíncronas.
Configure
Configure
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
Disponibilidad
El modelo, la URL del endpoint y la clave de API deben pertenecer a la misma región. Las llamadas entre regiones fallarán.
- Seleccionar un modelo: Confirm la región del modelo.
- Seleccionar una URL: Utilice la URL de endpoint correspondiente a la región. Se admiten URLs HTTP.
- Configurar clave de API: Seleccione una región y Obtenga una clave de API, luego Configure la clave de API como variable de entorno.
El código de ejemplo en este tema aplica a la región de Singapur.
HTTP
Las tareas de generación de video suelen tardar entre 1 y 5 minutos. La API utiliza llamadas asíncronas con dos pasos: "crear una tarea -> sondear el resultado". Los detalles son los siguientes:
Paso 1: Crear una tarea
- Singapore
- EE. UU. (Virginia)
- Fráncfort
- China (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 solicitudEncabezadosContent-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 modelo a utilizar. Consulte Precios de modelos para ver los modelos disponibles y sus precios.Ejemplo: wan2.6-r2v-flash.input object (Obligatorio)Parámetros de entrada como el prompt.
Propiedades prompt string (Obligatorio)Prompt de texto que describe los elementos deseados y las características visuales del video generado.Admite chino e inglés. Cada carácter cuenta como uno. El contenido que exceda el límite se trunca automáticamente.
string (Opcional)Prompt negativo que describe los elementos no deseados en el video.Admite chino e inglés. Longitud máxima: 500 caracteres. El contenido que exceda el límite se trunca automáticamente.Ejemplo: baja resolución, errores, peor calidad, baja calidad, incompleto, dedos adicionales, malas proporciones, etc.reference_urls array[string] (Obligatorio)Matriz de URLs de archivos de referencia. Admite entradas de video e imagen. Se utiliza para extraer la apariencia y la voz del personaje (si está disponible) con el fin de generar videos que coincidan con las características de referencia.
Obsoleto reference_video_urls array[string]Matriz de URLs de videos de referencia. Se utiliza para extraer la apariencia y la voz del personaje (si está disponible) con el fin de generar videos que coincidan con las características de referencia.
object (Opcional)Parámetros de generación de video, como resolución, reescritura de prompts y marca de agua.
Propiedades size string (Opcional)Resolución del video generado, en formato width*height. El valor predeterminado y las opciones disponibles dependen del parámetro model:
integer (Opcional)Duración del video generado, en segundos.
string (Opcional)Composición de tomas del video generado, que determina si el video consiste en una sola toma continua o en múltiples tomas.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 dice "generar un video de múltiples tomas".Valores válidos:
Utilice este parámetro para controlar la estructura narrativa del video, como una sola toma para exhibiciones de productos o múltiples tomas para clips narrativos. boolean (Opcional)Modelo admitido: wan2.6-r2v-flash.Si se debe generar audio en el video.Valores válidos:
boolean (Opcional)Indica si se debe agregar una marca de agua. La marca de agua aparece 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. |
Pase URLs de imágenes y videos mediante reference_urls. Establezca shot_type en multi para video de múltiples tomas. |
Parámetros de respuestaoutputobjectSalida 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: Recuperar el resultado de la tarea
- Singapore
- EE. UU. (Virginia)
- Fráncfort
- China (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 solicitudEncabezadosAuthorizationstring (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.Parámetros de rutatask_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 respuestaoutputobjectSalida de la tarea.
Propiedades task_id string (Obligatorio)El ID de la tarea.task_status stringEstado 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.objectEstadísticas de uso. Solo cuenta resultados exitosos.
Propiedades input_video_duration integerDuración del video de referencia de entrada, en segundos.output_video_duration integerDuración del video de salida, en segundos.duration floatDuración total del video. La facturación se basa en este valor.Fórmula: duration = input_video_duration + output_video_duration.SR integerNivel de resolución del video generado. Ejemplo: 720.size stringResolución del video generado en formato width*height. Ejemplo: 1280*720.video_count integerNúmero de videos generados. Siempre 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 parámetros del SDK siguen las mismas convenciones de nomenclatura que la API HTTP, con encapsulamientos específicos para cada lenguaje.
Las tareas de referencia a video suelen tardar entre 1 y 5 minutos. El SDK encapsula el flujo de trabajo asíncrono HTTP y admite llamadas síncronas y asíncronas.
El tiempo real de procesamiento depende de la cola de tareas y la carga del servidor.
Python
Configure 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):
- Singapore
- China (Beijing)
- Fráncfort
region="ap-southeast-1"Reemplace {WorkspaceId} con su ID de espacio de trabajo real.- Síncrono
- Asíncrono
Las llamadas síncronas bloquean la ejecución hasta que se completa la generación del video y se devuelve el resultado.
Ejemplo de solicitud
Java
Configure baseHttpApiUrl según la región del modelo:
- Singapore
- China (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.- Síncrono
- Asíncrono
Las llamadas síncronas bloquean la ejecución hasta que se completa la generación del video y se devuelve el resultado.