Wan3.0 es un modelo todo en uno de generación de video basada en referencia que admite Texto a video, Imagen a video (primer fotograma/primer-último fotograma) y Generación de video basada en referencia. Puede generar videos de hasta 30 segundos de duración a 30fps. Actualmente en vista previa.
Para consultar la guía de uso, véase Wan3.0 - Generación de video.
Para garantizar una llamada exitosa a la API, asegúrese de que el modelo, la URL del endpoint y la API Key pertenezcan todos a la misma región. Las llamadas entre regiones fallarán.
Dado que las tareas de generación de video toman un tiempo relativamente largo (típicamente 1-5 minutos), la API utiliza llamadas asíncronas. Todo el proceso consta de dos pasos principales: "Crear una tarea -> Sondear resultados", como se describe a continuación:
Reemplace
Texto a video: Pase únicamente
Imagen a video, Generación de video basada en referencia, Edición de video, Extensión de video y otros modos requieren pasar materiales a través de la matriz
El modo de primer fotograma/primer-último fotograma de Wan3.0 solo admite
Requisitos previos
Para garantizar una llamada exitosa a la API, asegúrese de que el modelo, la URL del endpoint y la API Key pertenezcan todos a la misma región. Las llamadas entre regiones fallarán.
- Seleccionar un modelo: Vaya a Model Gallery para seleccionar un modelo y confirmar la región a la que pertenece.
- Seleccionar una URL: Seleccione la URL del endpoint correspondiente a la región.
- Configurar API Key: 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 se aplica a la región de Singapur.
Llamada HTTP
Dado que las tareas de generación de video toman un tiempo relativamente largo (típicamente 1-5 minutos), la API utiliza llamadas asíncronas. Todo el proceso consta de dos pasos principales: "Crear una tarea -> Sondear resultados", como se describe a continuación:
Paso 1: Cree una tarea y obtenga el ID de tarea
- Singapore
- Beijing
- EE. UU. (Virginia)
- Japan (Tokyo)
- Germany (Frankfurt)
- China (Hong Kong)
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 solicitudEncabezados de solicitud (Headers)Content-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 solicitud (Request Body)modelstring (Obligatorio)Nombre del modelo. Valores válidos:
object (Obligatorio)Información básica de entrada. Se debe proporcionar prompt o media.
Propiedades prompt string (Condicionalmente obligatorio)Indicación de texto utilizada para describir el contenido de video deseado. Debe proporcionarse este parámetro o media.Admite tanto chino como inglés. Cada carácter chino o letra cuenta como un carácter, con un máximo de 20,000 caracteres. El contenido que exceda este límite se truncará automáticamente.En el modo de referencia, puede usar "Imagen 1", "Video 1", etc. en la indicación para referirse a los recursos multimedia en el orden correspondiente dentro de la matriz multimedia.media array (Condicionalmente obligatorio)Matriz de recursos multimedia que admite imágenes, videos, audio, archivos y páginas web como entrada. Debe proporcionarse esta matriz o prompt.
Propiedades type string (Obligatorio)Tipo de recurso multimedia. Valores válidos:
string (Obligatorio)URL del recurso multimedia o datos codificados en Base64.
Imagen de entrada (type=first_frame / last_frame / reference_image) URL de imagen o datos codificados en Base64.Límites de imagen:
Video de entrada (type=reference_video) URL del video de referencia.Límites de video:
Audio de entrada (type=reference_audio) URL del audio de referencia.Límites de audio:
Archivo de entrada (type=file) URL del archivo.Límites de archivo:
Enlace web de entrada (type=link) URL de una página web pública. Solo admite el análisis de páginas web de acceso público que no requieren inicio de sesión (como noticias, blogs, cuentas públicas, etc.).Formatos de entrada admitidos:
object (Opcional)Parámetros de procesamiento de video.
Propiedades resolution string (Opcional)Nivel de resolución del video generado. Valor predeterminado: 1080P. Valores válidos:
string (Opcional)Relación de aspecto del video generado. Valores válidos:
integer (Opcional)Duración del video generado, en segundos. Valor predeterminado: 5.
boolean (Opcional)Indica si el video de salida contiene audio.
integer (Opcional)Semilla aleatoria. Utilizada para reproducir resultados de generación. Rango de valores: -1 o [0, 2147483647]. Cuando se establece en -1 o no se especifica, el sistema genera automáticamente una semilla aleatoria. Incluso con el mismo valor de semilla, los resultados de generación pueden no ser perfectamente idénticos.prompt_extend boolean (Opcional)Si se debe habilitar la reescritura inteligente de indicaciones. Cuando está habilitada, un modelo de lenguaje grande reescribe la indicación de entrada. Esto mejora significativamente la calidad de generación para indicaciones más cortas, pero aumenta la latencia.
boolean (Opcional)Si se debe añadir una marca de agua.
|
Pase un archivo mediante el tipo file, y el modelo comprenderá automáticamente el contenido del archivo para generar un video. |
Parámetros de respuestaoutputobjectInformació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 resultados por ID de tarea
- Singapore
- Beijing
- EE. UU. (Virginia)
- Japan (Tokyo)
- Germany (Frankfurt)
- China (Hong Kong)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}- 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 solicitud (Headers)Authorizationstring (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.Parámetros de ruta URL (Path parameters)task_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 respuestaoutputobjectInformación de salida 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.orig_prompt stringEl prompt de entrada original.video_url stringURL del video generado. Se devuelve cuando la tarea se completa correctamente. El formato de video es MP4 (codificación H.264).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 salida. Solo cuenta resultados exitosos.
Propiedades video_count integerNúmero de videos generados. Fijo en 1.duration floatDuración total del video, en segundos. Cuando no se proporciona ningún video de referencia de entrada, equivale a la duración del video de salida; cuando se proporciona un video de referencia de entrada, equivale a la suma de la duración del video de entrada y la duración del video de salida.input_video_duration floatDuración del video de entrada, en segundos. Devuelve 0.0 cuando no se proporciona ningún video como entrada.output_video_duration floatDuración del video de salida, en segundos.fps integerVelocidad de fotogramas del video generado. Valor predeterminado: 30.SR integerResolución del video generado. Ejemplo: 720.ratio stringRelación de aspecto del video generado. Ejemplo: 16:9.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. |
Combinaciones de materiales
Solo se admiten las siguientes combinaciones específicas de materiales. Pasar otras combinaciones resultará en un error.
prompt. media no es compatible.
media, con cada elemento especificando type y url. Reglas de combinación de type:
- Los tipos
first_frame/last_frameyreference_image/reference_video/reference_audio/file/linkson mutuamente excluyentes y no pueden usarse juntos en la misma solicitud. fileylinkson mutuamente excluyentes (elija uno), pero ambos pueden combinarse conreference_image/reference_video/reference_audio.reference_image/reference_video/reference_audiopueden combinarse libremente entre sí.
FAQ
¿Por qué no puedo pasar audio u otros recursos multimedia en el modo de primer fotograma/primer-último fotograma?
El modo de primer fotograma/primer-último fotograma de Wan3.0 solo admite first_frame y last_frame, y no puede aceptar otros tipos como audio al mismo tiempo (véase Combinaciones de materiales).
Diferencia con la Wan2.7 serie Imagen a video: El modo de primer fotograma/primer-último fotograma de Wan2.7 admite pasar driving_audio para generación impulsada por audio; el modo de primer fotograma/primer-último fotograma de Wan3.0 no lo admite. Si necesita generación impulsada por audio, utilice el modo de referencia multimodal (combinación de reference_image + reference_audio) en su lugar. Para un uso específico, consulte Wan3.0 - Guía de generación de video.