Saltar al contenido principal
POST
Este endpoint es asíncrono. Tras enviar la solicitud, usa el task_id devuelto con GET /v1/videos/generations/{task_id} para consultar el estado y el resultado.

Funciones del modelo

PixVerse V6 Max es la versión de mayor calidad de imagen de PixVerse V6. Solo admite texto a vídeo y generación desde una sola imagen, usando el mismo modelo pixverse-v6-max. Para transiciones entre fotogramas inicial y final, fusión de varias imágenes y extensión de vídeo, usa PixVerse V6.

Cabeceras de la solicitud

string
requerido
Autenticación Bearer: Bearer <token>, donde <token> es tu clave API de APIMart.

Parámetros de la solicitud

string
requerido
Debe ser pixverse-v6-max.
string
Describe el contenido que se generará. Obligatorio en texto a vídeo, hasta 5000 caracteres; opcional en imagen a vídeo, hasta 2048 caracteres.
string[]
Lista de URL de imágenes de entrada. Imagen a vídeo acepta exactamente 1 imagen; enviar 2 o más devuelve HTTP 400 de forma síncrona. Omite este campo para texto a vídeo.Las imágenes deben ser accesibles públicamente por HTTP(S), en formato JPEG, PNG o WebP, de menos de 20 MB y con cada lado de hasta 10000 píxeles.
integer
predeterminado:"5"
Duración de salida en segundos, de 1 a 15; valor predeterminado: 5.
string
predeterminado:"540p"
Resolución de salida: 360p, 540p, 720p o 1080p; valor predeterminado: 540p.La salida usa las dimensiones nativas del modelo subyacente; prevalecen las dimensiones realmente devueltas. Entre los tamaños observados en pruebas están 640×360 y 1108×832 (ancho × alto, en píxeles).También se acepta quality. Si se envían ambos campos, resolution tiene prioridad.
string
Campo de compatibilidad para la resolución, con los mismos valores que resolution. Solo se usa si se omite resolution; si se omiten ambos, se usa 540p.
string
predeterminado:"16:9"
Solo se aplica a texto a vídeo. Admite 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 y 21:9; valor predeterminado: 16:9.Imagen a vídeo siempre sigue la relación de aspecto de la imagen de entrada; este campo no tiene efecto.
boolean
predeterminado:"false"
Establece true para generar audio nativo; por defecto, el vídeo es silencioso. La generación con audio tiene un precio por segundo más alto.Solo se reconoce audio en el nivel superior del cuerpo de la solicitud. metadata.generate_audio_switch no activa el audio ni la tarifa con audio.
integer
Semilla aleatoria, de 0 a 2147483647.

Ejemplo de imagen a vídeo

Sustituye la URL de ejemplo por la de una imagen real y accesible públicamente. Envía solo 1 imagen; la relación de aspecto de salida seguirá esa imagen.

Consultar una tarea

Sustituye el ID de tarea de la siguiente solicitud por el task_id devuelto al enviarla:

Facturación

El coste es la duración de salida en segundos multiplicada por la tarifa por segundo de la resolución y la opción de audio elegidas. La generación con y sin audio usa tarifas distintas; con audio cuesta más por segundo. Si no se especifica resolution ni quality, tanto la salida como la facturación usan 540p. Las tarifas actuales se obtienen del endpoint de precios del modelo:

Funciones no admitidas y errores de parámetros

Las siguientes solicitudes devuelven HTTP 400 de forma síncrona, sin crear una tarea ni cobrar: