Skip to main content
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 con omni-moderation-latest
  • false u 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: SD
  • 540p: Estándar (predeterminado)
  • 720p: HD
  • 1080p: Full HD
Otros valores de resolución devolverán un error de parámetro.
integer
predeterminado:"5"
Duración del video en segundos, rango 1–15.
El modo de transición de primer/último frame solo admite 5 u 8 segundos.
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:3
  • 1:1: Cuadrado
  • 3:4: Vertical 3:4
  • 9:16: Vertical
  • 2:3: Vertical 2:3
  • 3:2: Horizontal 3:2
  • 21: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 agua
  • false: Sin marca de agua (predeterminado)
string
Modo de movimiento.
  • normal: Modo estándar (pixverse-v6 solo admite este valor)
fast solo se aplica a modelos antiguos y será rechazado por el upstream para pixverse-v6.
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 clips
  • false: 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.
Todas las entradas de imagen solo aceptan URL HTTP/HTTPS accesibles públicamente. base64 y Data URI no son compatibles. Si solo dispone de imágenes locales, súbalas primero a un object storage y pase la URL.

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 un task_id. Use el endpoint Obtener estado de la tarea para consultar progreso y resultado.
cURL
Se recomienda hacer polling cada 5 segundos hasta que el estado sea completed o failed.

Ejemplo de éxito

La URL del video está en 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

En caso de fallo, cost suele ser 0. La causa del error está en data.error.message.

Casos de uso

Caso 1: Texto a video

Caso 2: Imagen a video

Caso 3: Transición primer/último frame

Caso 4: Fusión multi-referencia

Caso 5: Extensión de video