Pixverse v6
Pixverse v6 Generación de Video
- Modelo unificado de generación de video Pixverse v6
- Soporta texto a video, imagen a video, transición de primer/último frame, fusión multi-referencia y extensión de video
- Resoluciones 360p/540p/720p/1080p, duración de 1–15 segundos
- API de tareas asíncronas: tras el envío, consulte el resultado por ID de tarea
POST
Autenticación
string
requerido
Todos los endpoints requieren autenticación mediante Bearer Token.Obtener una API Key:Visite la página de gestión de API Key para obtener su API Key.Añada la siguiente cabecera a la solicitud:
Parámetros de la solicitud
string
requerido
Nombre del modelo de generación de video. Fijo en
pixverse-v6.boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
true: revisar los prompts y las imágenes de entrada conomni-moderation-latestfalseu omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción del contenido del video, hasta 5000 caracteres. Obligatorio en todos los modos.
string
predeterminado:"540p"
Nivel de resolución del video. Afecta directamente la facturación.
360p: SD540p: Estándar (predeterminado)720p: HD1080p: Full HD
integer
predeterminado:"5"
Duración del video en segundos, rango
1–15.string
predeterminado:"16:9"
Relación de aspecto del video. Solo efectivo en los modos texto a video y fusión multi-referencia.
16:9: Horizontal panorámico (predeterminado)4:3: Horizontal 4:31:1: Cuadrado3:4: Vertical 3:49:16: Vertical2:3: Vertical 2:33:2: Horizontal 3:221:9: Cinematográfico panorámico
integer
predeterminado:"0"
Semilla aleatoria, rango
0–2147483647. El mismo prompt y semilla pueden reproducir resultados similares.string
Prompt negativo para excluir contenido no deseado. Hasta 2048 caracteres.
boolean
predeterminado:"false"
Si se genera una pista de audio.
true: Generar audio (aumenta el precio)false: Sin audio (predeterminado)
boolean
predeterminado:"false"
Si se añade marca de agua en la esquina inferior derecha del video.
true: Añadir marca de aguafalse: Sin marca de agua (predeterminado)
string
Modo de movimiento.
normal: Modo estándar (pixverse-v6solo admite este valor)
boolean
predeterminado:"false"
Si se genera un video continuo de múltiples clips. Solo soportado en los modos texto a video e imagen a video.
true: Generar video continuo de múltiples clipsfalse: Clip único (predeterminado)
array<url>
Array de URL de imágenes de entrada para imagen a video. Solo se utiliza la primera imagen.Las imágenes deben ser URL HTTP/HTTPS accesibles públicamente.
url
URL del primer frame en el modo de transición. Debe enviarse junto con
last_frame_image.url
URL del último frame en el modo de transición. Debe enviarse junto con
first_frame_image.array<url>
Array de URL de imágenes de referencia para el modo de fusión multi-referencia. Soporta 1–7 imágenes.Pasar este campo activa el modo de fusión multi-referencia.
string
ID de la tarea de origen para la extensión de video. Pasar este campo activa el modo de extensión.La tarea de origen debe pertenecer al usuario actual, usar el modelo
pixverse-v6 y tener estado completed.Modos de generación
El adaptador despacha automáticamente al modo de generación correspondiente según los campos de la solicitud. La coincidencia se realiza por orden de prioridad; gana el primero que coincide.Reglas de parámetros
Respuesta
integer
Código de estado de la respuesta.
200 en caso de éxito.array
Array de tareas devuelto.
Consulta del resultado de la tarea
La generación de video es una tarea asíncrona. Tras el envío se devuelve untask_id. Use el endpoint Obtener estado de la tarea para consultar progreso y resultado.
cURL
completed o failed.
Ejemplo de éxito
data.result.videos[0].url[0]. El campo url es a su vez un array. Los enlaces de video suelen caducar tras 24 horas; descárguelos o transfiéralos a tiempo.
Ejemplo de fallo
cost suele ser 0. La causa del error está en data.error.message.