PixVerse V6

PixVerse V6 es el modelo de vídeo de PixVerse. Un solo ID de modelo cubre cinco modos: texto a vídeo, imagen a vídeo, una transición entre un primer y un último fotograma, referencias de varias imágenes y extender un clip que ya hayas creado. El modo depende de los campos que envías. Los clips duran de 1 a 15 segundos en 360p, 540p, 720p o 1080p, con audio nativo opcional. Envía la solicitud, guarda el identificador de tarea devuelto y lee el vídeo terminado desde la tarea. Las imágenes se envían como URL.

ID de modelo

Consulta la página del modelo para ver los precios actuales. Para una toma con más detalle desde texto o una imagen, consulta PixVerse V6 Max.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "540p",
    "duration": 5,
    "size": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no el vídeo terminado. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del lado del servidor.

Parámetros

El esquema es estricto: los campos desconocidos se rechazan en lugar de ignorarse. callback_url no está disponible; consulta la tarea en su lugar.

Modos

Los campos que envías eligen el modo. Envía los campos de un solo modo por solicitud.

{
  "model": "pixverse-v6",
  "prompt": "The puppy slowly turns into a kitten, soft studio light.",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/kitten.jpg",
  "duration": 5
}

{
  "model": "pixverse-v6",
  "prompt": "The paper boat drifts on toward a lily pad.",
  "extend_from_task_id": "task_...",
  "resolution": "540p",
  "duration": 5
}

Una extensión devuelve el clip de origen seguido del segmento nuevo y solo factura la duration del segmento nuevo. En nuestra prueba, una extensión de 1 segundo de un clip de 1 segundo llegó con una duración de 2,1 segundos y se facturó como 1 segundo.

Entradas multimedia

Las imágenes son URL HTTP(S) públicas. No se aceptan URI de datos base64: sube el archivo a tu propio almacenamiento y envía su URL. Usa imágenes JPG, PNG o WebP de 20 MB o menos.

Factores de coste

Consulta la sección de precios del modelo para ver las tarifas actuales. PixVerse V6 se factura por segundo de vídeo, a una tarifa que depende de la resolución y de si se genera audio:

cost = duration × rate per second for the resolution and audio setting

Todos los modos cuestan lo mismo por segundo; una extensión solo factura el segmento nuevo. La duración se conoce cuando se acepta la solicitud, así que el importe reservado es el importe cobrado. Consulta los cargos definitivos en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Sondea cada 10–20 segundos hasta que status sea completed o failed. Que se agote el tiempo de red durante el sondeo no significa que la generación haya fallado: conserva el identificador de tarea y reanuda la comprobación. No crees otra tarea para consultar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689640,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

En nuestras pruebas, los clips de 1 segundo en 360p y 16:9 llegaron como MP4 (H.264) de 640 × 360, 36–45 segundos después del envío.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo de errores común para ver códigos, estados HTTP y pautas de reintento.

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, revisa tus tareas antes de volver a enviar: puede que la primera solicitud se haya aceptado.

Consejos

• Describe el sujeto, el lugar, el movimiento de cámara y la luz en el prompt; indica los sonidos que quieres cuando audio esté activado.
• Haz los borradores en 360p o 540p y luego renderiza la toma final en 1080p con la misma solicitud y seed.
• Para vídeo vertical, envía size: "9:16" con texto a vídeo o una imagen vertical.
• Añade no text, no logos para evitar marcas inventadas.

Relacionado

• Playground y precios de PixVerse V6
• Referencia de la API de PixVerse V6 Max
• Descargar OpenAPI
• Markdown copiable