Video
PixVerse V6 Max
Genera con PixVerse V6 Max clips de 1 a 15 segundos desde un prompt o una imagen, de 360p a 1080p con audio opcional, facturados por segundo y entregados como tarea.
PixVerse V6 Max es la versión con más detalle de PixVerse V6. Crea un clip de 1 a 15 segundos desde un prompt, o desde una imagen inicial con un prompt opcional, 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
| ID de modelo | Entradas | Resoluciones | Duración |
|---|---|---|---|
pixverse-v6-max | texto, una imagen | 360p, 540p, 720p, 1080p | De 1 a 15 segundos |
Consulta la página del modelo para ver los precios actuales. Las transiciones, las referencias de varias imágenes y extender clips son funciones de PixVerse V6.
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-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'Endpoint
POST https://api.seedrouter.ai/v1/videos/generations| Encabezado | Valor |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
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
| Campo | Tipo | Por defecto | Notas |
|---|---|---|---|
model | cadena | obligatorio | pixverse-v6-max |
prompt | cadena | ver notas | Texto a vídeo: obligatorio, hasta 5.000 caracteres. Con una imagen: opcional, hasta 2.048 caracteres. |
image_urls | lista de URL | ninguno | Imagen a vídeo: exactamente una imagen. Sin ella, el clip es de texto a vídeo. |
resolution | enumeración | 540p | 360p, 540p, 720p o 1080p. |
quality | enumeración | ninguno | Alias de resolution, con los mismos valores. resolution prevalece cuando se envían ambos. |
duration | entero | 5 | De 1 a 15 segundos. |
aspect_ratio | enumeración | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 o 21:9. Solo para texto a vídeo; con una imagen, el clip sigue la forma de la imagen. |
audio | booleano | false | Genera audio nativo. Se factura a la tarifa con audio. |
seed | entero | ninguno | 0–2147483647. La misma solicitud y semilla producen resultados similares. |
El esquema es estricto: los campos desconocidos se rechazan en lugar de ignorarse. first_frame_image, last_frame_image, img_references y extend_from_task_id devuelven un 400 que remite a pixverse-v6. callback_url no está disponible; consulta la tarea en su lugar.
Imagen a vídeo
Envía una imagen en image_urls. El clip empieza con ella y mantiene su forma, así que una imagen vertical produce un clip vertical. Aquí el prompt es opcional.
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}Entradas multimedia
La imagen es una URL HTTP(S) pública. No se aceptan URI de datos base64: sube el archivo a tu propio almacenamiento y envía su URL. Usa una imagen JPG, PNG o WebP de 20 MB o menos y de 10.000 píxeles como máximo por lado.
Factores de coste
Consulta la sección de precios del modelo para ver las tarifas actuales. PixVerse V6 Max 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 settingTexto a vídeo e imagen a vídeo cuestan lo mismo. 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-max", "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-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"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, 81–89 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-max",
"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
audioesté activado. - Haz los borradores en
360po540py luego renderiza la toma final en1080pcon la misma solicitud yseed. - Para vídeo vertical, envía
aspect_ratio: "9:16"o una imagen vertical. - Añade
no text, no logospara evitar marcas inventadas.
