Vidu Q3 Pro API

Vidu Q3 Pro es el nivel Pro de la línea de video Q3 de Vidu y está disponible como un único endpoint de imagen a video. Envías un fotograma inicial en image_url y una indicación en prompt, ambos obligatorios, y recibes de 1 a 16 segundos enteros de video en 540p, con audio generado en la misma pasada. El fotograma define el sujeto, el estilo y la forma del resultado; no hay campo de relación de aspecto y la proporción de la imagen debe estar entre 1:4 y 4:1, así que el prompt solo tiene que describir lo que se mueve.

Una sola resolución: solo decides la duración

resolution acepta un único valor, 540p, y todos los clips vuelven con ese tamaño. Queda duration_seconds –cualquier número entero de 1 a 16, 5 de forma predeterminada– como el ajuste que cambia a la vez la duración del clip y el precio, y la estimación en vivo lo sigue mientras lo mueves.

La identidad viene de la imagen fija

El sujeto, el vestuario, el encuadre y la forma del resultado los define la imagen, no el prompt. Dos generaciones con el mismo fotograma se diferencian en el movimiento, no en quién aparece en pantalla, y por eso una serie de clips de una sola imagen se puede montar junta. También significa que la solicitud de video no puede reescribir nada de lo que se aprobó en la etapa de imagen.

Escribe el movimiento y luego fija cuánto

movement_amplitude fija la cantidad general de movimiento –auto por defecto, o small, medium, large– y el prompt dice qué se mueve y cómo. Si una toma se mueve demasiado o muy poco, mantén fijos seed y el fotograma y reescribe solo el movimiento –un giro más corto, un paso más lento– para que la diferencia que ves venga de esa única edición y no de un sorteo nuevo.

Series de reacciones de un personaje

Un fotograma con vestuario se convierte en un guiño, un saludo con la mano, una inclinación de cabeza y un giro: cuatro solicitudes con la misma imagen y cuatro prompts distintos. Como la identidad la fija el fotograma, la serie se monta sin que nadie cambie de un clip a otro.

Acción cercana y rítmica

El ejemplo de la forja se mantiene seis segundos cerca del pecho y los antebrazos de un herrero, iluminados desde abajo por el fuego, con chispas en cada golpe de martillo. Los impactos repetidos son una buena prueba para este endpoint: las chispas tienen que aparecer en los golpes y no entre ellos.

Entregables verticales

Exporta la imagen en 9:16 y el clip vuelve en vertical. En el ejemplo del paso subterráneo, el prompt solo lleva la caminata hacia el lente bajo los tubos de luz y una cámara que retrocede a su ritmo; el encuadre vertical se decidió en la etapa de imagen.

Escenas sin censura a partir de tu propio fotograma

Tu imagen se anima tal como llega en lugar de suavizarse, y como la imagen lleva el contenido, el resultado se mantiene cerca de lo aprobado. Vidu Q3 Spicy, de la misma línea, es la variante sin censura afinada con LoRA.

# 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/q3-pro/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "movement_amplitude": "auto",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "540p"
  }
}'

# 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.