Introducción
Vidu Q4 Preview Reference to video construye una escena a partir de 1 a 15 imágenes de referencia y hasta 3 clips de voz. Vidu Q4 Preview es la vista previa pública del modelo de video Q4 de Vidu. Los clips duran de 3 a 16 segundos, de 540p a 4k, en cinco proporciones, con sonido generado junto a la imagen. Este endpoint tiene un filtrado ligero: desde el nivel Moderado, la mayoría de las solicitudes se suavizan o se rechazan.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un cuadro para animar | Vidu Q4 Preview Imagen a video |
| personas, atuendos, productos o lugares como imágenes, con clips de voz opcionales | Vidu Q4 Preview Referencia a video |
Funciones y aspectos destacados
Hasta 15 referencias
Personas, atuendos, productos y lugares pueden entrar juntos. En nuestras ejecuciones un rostro, una prenda y una habitación volvieron como una sola escena.
Dos personas, ambas reconocibles
Dos retratos como referencias mantuvieron ambos rostros en el mismo plano.
Voz de referencia
Hasta 3 clips de audio definen la voz. Las palabras siguen viniendo del prompt, así que escribe la frase entre comillas.
Cinco formas y cinco niveles
aspect_ratio ofrece 16:9, 9:16, 1:1, 3:4 y 4:3; resolution va de 540p a 4k, con 2k y 4k en HEVC de 10 bits.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 20,000 caracteres. Describe la escena y remite a las referencias por posición, por ejemplo «la mujer de la primera imagen». mínimo 1 caracteres · máximo 20000 caracteres |
reference_image_urls | Sí | Obligatorio, de 1 a 15 imágenes de personas, atuendos, productos o lugares. Una solicitud sin ninguna se rechaza. mínimo 1 elementos · máximo 15 elementos |
reference_audio_urls | No | Opcional, hasta 3 clips de voz (Vidu pide MP3 de 3 a 12 segundos cada uno). mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | 16:9 (por defecto), 9:16, 1:1, 3:4 o 4:3. No modifica el precio. |
resolution | No | 540p, 720p (por defecto), 1080p, 2k o 4k. Define el precio por segundo: 2k cuesta más que 1080p, y 4k cerca del doble que 2k. |
duration_seconds | No | Segundos enteros, de 3 a 16, 5 por defecto. Se cobra por segundo junto con la resolución. |
generate_audio | No | Activado por defecto: diálogos, efectos y ambiente se generan junto con la imagen. Desactívalo para un clip sin pista de audio. Valor predeterminado: |
seed | No | Mantiene las ejecuciones comparables mientras cambias una sola cosa a la vez. No garantiza un clip idéntico fotograma a fotograma. |
Precios
Se cobra por segundo de salida según la resolución elegida. El sonido, el número de imágenes de referencia y el número de clips de audio de referencia no modifican el precio. Las solicitudes rechazadas no se cobran.
| Especificación | Precio |
|---|---|
| $0.045 / segundo |
| $0.095 / segundo |
| $0.12 / segundo |
| $0.19 / segundo |
| $0.39 / segundo |
Casos de uso
Escenas de moda y de producto
Una modelo, una prenda y una locación en un solo clip.
Planos con dos personas
Una conversación, una llegada o un casi beso con ambos rostros conservados.
Personajes con voz
Un retrato más un clip de voz y una frase entre comillas.
Guía de prompts y consejos prácticos
Remite por posición
Di «la mujer de la primera imagen» y «la bata de la segunda imagen».
Escribe la frase
Un clip de voz no aporta las palabras. Pon la frase entre comillas e indica que va con la voz del audio de referencia.
Conoce el filtro
Las solicitudes de nivel Suave pasaron, al igual que uno de los dos prompts de nivel Máximo; desde el nivel Moderado, las demás se rechazaron o se suavizaron en nuestras pruebas, y los rechazos no se cobran. Para escenas más allá de estos límites, usa imagen a video a partir de un fotograma de las personas.
Borrador en 540p
Prueba el prompt en 540p y termina en 1080p. Elige 2k o 4k solo si puedes manejar archivos HEVC.
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": "vidu/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# 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.












