El modelo de imagen a video de PixVerse genera un video fluido a partir de una imagen de entrada y una indicación de texto.
Activar el servicio
- Vaya a la consola de Model Studio, busque PixVerse, encuentre la tarjeta del modelo PixVerse y haga clic en Activate Now.
- En la ventana emergente, confirme la activación y la autorización.
Notas de uso
Para garantizar llamadas a la API exitosas, debe utilizar un modelo, una URL de endpoint y una clave de API que pertenezcan todos a la misma región. Las llamadas entre regiones fallarán.
- Seleccionar un modelo: Confirme la región donde se encuentra su modelo.
- Seleccionar una URL: Elija la URL de endpoint de la región correspondiente. Se admiten tanto URLs HTTP como del SDK de DashScope.
- Configurar una clave de API: Obtenga una clave de API para la región y 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.
Llamadas HTTP
La generación de imagen a video es una tarea de larga duración que normalmente toma de 1 a 5 minutos, por lo que la API utiliza llamadas asíncronas. El flujo de trabajo consta de dos pasos principales: "Crear una tarea -> Sondear el resultado". Los pasos son los siguientes:
Paso 1: Crear una tarea para obtener un ID de tarea
Región de Singapur: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Reemplace {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 de 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.Valores válidos:
object (Obligatorio)La información de entrada básica, como la indicación de texto y los recursos multimedia.
Propiedades prompt string (Opcional)La indicación de texto. Describe los elementos deseados y las características visuales del video generado.Se admiten tanto chino como inglés. Cada carácter chino o letra cuenta como un carácter. La codificación de caracteres es UTF-8. Los caracteres que excedan el límite se truncan automáticamente.
array (Obligatorio)Una lista de recursos multimedia que especifica la imagen necesaria para la generación del video.Cada elemento de la matriz es un objeto multimedia que contiene los campos type y url.
Propiedades type string (Obligatorio)El tipo de recurso multimedia. Valor fijo:
Si proporciona varias imágenes, el sistema utiliza la última de forma predeterminada. Para garantizar los resultados esperados, proporcione siempre una sola imagen.url string (Obligatorio)La URL del archivo de imagen. La URL debe ser accesible públicamente.
object (Obligatorio)Parámetros de procesamiento de video, como la resolución, la duración del video, la generación de audio y la marca de agua.
Propiedades resolution string (Obligatorio)Especifica el nivel de resolución del video generado.Valores válidos: 360P, 540P, 720P y 1080P.duration integer (Obligatorio)La duración del video generado, en segundos.
boolean (Opcional)Especifica si se genera un video con audio. Si se habilita, el modelo genera automáticamente música de fondo o efectos de sonido acordes al contenido del video.
boolean (Opcional)Especifica si se debe añadir una marca de agua. La marca de agua se coloca en la esquina inferior derecha del video y muestra el texto fijo "AI Generated".
string (Opcional)Modelo compatible: pixverse/pixverse-v6-it2v.Especifica el tipo de toma del video generado. Controla si el video consta de una sola toma continua o de varias tomas.
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. |
Modelo compatible: pixverse/pixverse-v6-it2v. |
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 el resultado por ID de tarea
Región de Singapur: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
- Recomendación de sondeo: La generación de video puede tardar varios minutos. Utilice un mecanismo de sondeo y consulte el resultado a un intervalo razonable, como cada 15 segundos.
- Flujo de estado de la tarea: PENDING (en cola) → RUNNING (procesando) → SUCCEEDED (exitoso) / FAILED (fallido).
- Validez del ID de tarea: El
task_ides válido durante 24 horas. Después de este período, las consultas fallarán y la API devolverá un estado de tareaUNKNOWN. - Límite de RPS: El endpoint de consulta tiene un límite predeterminado de 20 RPS. Para consultas de alta frecuencia o notificaciones de eventos, configure devoluciones de llamada de tareas asíncronas.
- Más operaciones: Para realizar consultas por lotes, cancelar tareas u otras operaciones, consulte Gestionar tareas asíncronas.
Parámetros de solicitudEncabezadosAuthorizationstring (Requerido)Autentica la solicitud con una clave de 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 de 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 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. El formato es YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringLa hora en que se ejecutó la tarea. El formato es YYYY-MM-DD HH:mm:ss.SSS.end_time stringLa hora en que se completó la tarea. El formato es YYYY-MM-DD HH:mm:ss.SSS.video_url stringLa URL del video. Se devuelve solo cuando task_status es SUCCEEDED.El video está en formato MP4 (codificación H.264). Actualmente, el enlace del video no caduca, pero no dependa de él para el almacenamiento a largo plazo. Descargue el video a la brevedad.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 de salida, contadas solo para tareas exitosas.
Propiedades duration integerLa duración total del video generado, utilizada para la facturación.size stringLa resolución del video generado.fps integerLa tasa de cuadros del video generado.SR stringEl nivel de resolución del video generado.audio booleanIndica si el video generado tiene audio.video_count integerEl número de videos generados. Este valor es fijo en 1.shot_type stringEl tipo de toma del video generado.stringIdentificador único de solicitud para rastreo y solución de problemas. |
|