Introducción
PixVerse V6 Texto a video convierte un brief escrito en un clip de 1 a 15 segundos a 360p, 540p, 720p o 1080p, en ocho relaciones de aspecto de 16:9 a 9:16 y 21:9. Describe el sujeto, la acción y la cámara: los movimientos de cámara que escribas en el prompt se siguen, y PixVerse dice que V6 entiende más de 20 controles cinematográficos de lente y cámara a partir del prompt. Activa generate_audio y el modelo genera el sonido junto con la imagen. PixVerse revisa los prompts y las imágenes antes de generar; las solicitudes que rechaza fallan y no se cobran.
Elige un modo de PixVerse V6 según el material inicial
| Lo que tienes al inicio | Modo |
|---|---|
| una escena escrita | PixVerse V6 Texto a video (estás aquí) |
| un primer cuadro y, opcionalmente, un último cuadro | PixVerse V6 Imagen a video |
| fotos de personas, objetos o lugares con los que armar la escena | PixVerse V6 Referencia a video |
| un clip que quieres continuar | PixVerse V6 Extensión de video |
| un prompt o una sola imagen, y quieres mayor calidad de imagen | PixVerse V6 Max |
| una foto y una plantilla temática lista, sin prompt que escribir | PixVerse V6 Effects |
Funciones y aspectos destacados
Un párrafo, más de un encuadre
En nuestra prueba, un solo párrafo sobre una conductora riendo en un convertible turquesa vintage abrió con un plano cercano de ella, con el pañuelo ondeando; después la cámara subió a una toma aérea amplia del auto en la carretera del acantilado, sobre el océano. El prompt pedía que el dron se alejara y subiera; el corte del primer plano a la toma aérea lo decidió el modelo.
Un interruptor multi-toma
shot_type es single por defecto. Ponlo en multi para que el modelo corte el clip en varias tomas. No cambia el precio.
Ocho relaciones de aspecto
16:9 (por defecto), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 y 21:9. La relación de aspecto no cambia el precio.
Sonido cuando lo quieras
generate_audio está desactivado por defecto. Activado, el modelo genera ambiente, efectos, música y cualquier diálogo que escribas entre comillas. El sonido activado cuesta más por segundo.
Cuatro resoluciones
360p, 540p, 720p (por defecto) y 1080p. Nuestro clip de prueba fue a 540p, 1024x576, y tardó unos 41 segundos de tiempo de generación para 5 segundos de video.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, de 3 a 5.000 caracteres. Describe el sujeto, la acción, la cámara y la luz; los movimientos de cámara que escribes se siguen. mínimo 3 caracteres · máximo 5000 caracteres |
aspect_ratio | No | 16:9 (por defecto), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 o 21:9. No cambia el precio. |
resolution | No | 360p, 540p, 720p (por defecto) o 1080p. Las resoluciones más altas cuestan más por segundo. |
duration_seconds | No | Segundos enteros, de 1 a 15 (por defecto 5). El precio es por segundo. |
generate_audio | No | Desactivado por defecto. Activado, genera sonido junto con la imagen: ambiente, efectos, música y diálogos entre comillas. Valor predeterminado: |
shot_type | No | single (por defecto) o multi. multi permite que el modelo corte el clip en varias tomas. |
seed | No | Entero opcional de 0 a 2147483647. Sirve para comparar un cambio a la vez; no garantiza fotogramas idénticos. |
Precios
Se cobra por segundo de salida. La resolución y el interruptor de audio cambian el precio por segundo; la relación de aspecto, el tipo de toma y la semilla no. Las solicitudes fallidas o rechazadas no se cobran.
| Resolución | Generar audio: No | Generar audio: Sí |
|---|---|---|
| $0.0222 / segundo | $0.0311 / segundo |
| $0.0311 / segundo | $0.04 / segundo |
| $0.04 / segundo | $0.0533 / segundo |
| $0.08 / segundo | $0.1022 / segundo |
Casos de uso
Planos de apertura y de establecimiento
Escribe el lugar, la luz, un movimiento de cámara y el estilo, y tendrás una toma para abrir una escena. Nuestro ejemplo de la carretera del acantilado hace exactamente eso en un solo párrafo.
Escenas cortas con una línea hablada
Activa el audio, describe la acción y pon la línea entre comillas. Nombra el ambiente que quieres en el mismo prompt.
Encuadres verticales y ultra anchos
Elige 9:16, 3:4 o 2:3 para clips verticales, o 21:9 para ultra ancho. El precio por segundo es el mismo en cada relación de aspecto.
Guía de prompts y consejos prácticos
Escríbelo en el orden en que ocurre
Primero el lugar y la luz, luego el sujeto y el vestuario, la acción, el movimiento de cámara y el estilo. Nuestro ejemplo dice: hora dorada en una carretera costera al borde de un acantilado, el auto y la conductora, el dron que se aleja y sube, y un estilo cálido de película de 35 mm.
Escribe el movimiento de cámara
Los movimientos de cámara que pones en el prompt se siguen, así que nómbralos: "the drone pulls back and rises", "slow orbit", "handheld push-in".
Compara con una semilla
seed mantiene comparables las ejecuciones mientras cambias una cosa a la vez. No garantiza fotogramas idénticos.
Haz un borrador pequeño y luego termina
El precio es por segundo y la resolución lo cambia, así que encuentra el encuadre con un clip corto a menor resolución y luego genera la versión final a 720p o 1080p.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.


