El modelo de texto a video de PixVerse genera un video fluido a partir de 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: Seleccione una región, obtenga una clave de API y luego configure la clave de API como variable de entorno.
- Instalar el SDK: Para realizar llamadas con el SDK, instale el SDK de DashScope.
Llamadas HTTP
La generación de texto 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.
Propiedades prompt string (Obligatorio)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.
object (Obligatorio)Los parámetros de generación de video, como la resolución, la duración y si se genera audio.
Propiedades size string (Obligatorio)La resolución del video generado, en formato width*height en píxeles.La siguiente tabla enumera los valores válidos para los distintos niveles de resolución y relaciones de aspecto.
Modelo pixverse/pixverse-v6-t2v
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-t2v.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-t2v. |
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 está pensado 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 en segundos, 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. |
|
Llamadas del SDK de DashScope
Los nombres de los parámetros del SDK son en su mayoría coherentes con los de la API HTTP. La estructura de los parámetros se adapta a las características de cada lenguaje de programación.
Dado que las tareas de texto a video tardan bastante tiempo (normalmente de 1 a 5 minutos), el SDK encapsula el proceso de llamada asíncrona HTTP y admite métodos de llamada tanto síncronos como asíncronos.
El tiempo real necesario depende del número de tareas en cola y del estado de ejecución del servicio. Espere pacientemente el resultado.
Llamadas del SDK de Python
Región de Singapur: region="ap-southeast-1"
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
- Llamada síncrona
- Llamada asíncrona
Ejemplo de solicitud
Ejemplo de respuesta
Actualmente, video_url no caduca, pero no está pensado para el almacenamiento a largo plazo. Descargue el video a la brevedad.
Llamadas del SDK de Java
Región de Singapur: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
- Llamada síncrona
- Llamada asíncrona
Ejemplo de solicitud
Ejemplo de respuesta
Actualmente, video_url no caduca, pero no está pensado para el almacenamiento a largo plazo. Descargue el video a la brevedad.