Vidu Q3 Pro API

Vidu Q3 Pro è il livello Pro della linea video Q3 di Vidu ed è disponibile come unico endpoint da immagine a video. Invii un fotogramma iniziale in image_url e un'istruzione in prompt, entrambi obbligatori, e ricevi da 1 a 16 secondi interi di video a 540p, con l'audio generato nello stesso passaggio. Il fotogramma stabilisce soggetto, look e forma dell'output; non esiste un campo per il rapporto d'aspetto e le proporzioni dell'immagine devono restare tra 1:4 e 4:1. Al prompt resta quindi solo da descrivere ciò che si muove.

Una sola risoluzione: decidi solo la durata

resolution accetta un solo valore, 540p, e ogni clip torna in quella dimensione. Resta duration_seconds (qualsiasi numero intero da 1 a 16, predefinito 5), l'impostazione che cambia sia la lunghezza della clip sia il prezzo; la stima in tempo reale la segue mentre la sposti.

L'identità viene dall'immagine

Soggetto, abiti, inquadratura e forma dell'output sono stabiliti dall'immagine, non dal prompt. Due generazioni dallo stesso fotogramma differiscono nel movimento, non in chi compare sullo schermo, ed è questo che permette di montare insieme una serie di clip nate da una sola immagine. Significa anche che la richiesta video non può riscrivere nulla di ciò che è stato approvato nella fase dell'immagine.

Scrivi il movimento, poi fissane la quantità

movement_amplitude imposta la quantità complessiva di movimento – auto per impostazione predefinita, oppure small, medium, large – mentre il prompt dice che cosa si muove e come. Se una ripresa si muove troppo o troppo poco, tieni fissi seed e il fotogramma e riscrivi solo il movimento, per esempio una rotazione più piccola o una camminata più lenta, così la differenza che vedi nasce da quell'unica modifica e non da una nuova estrazione.

Serie di reazioni per un personaggio

Un fotogramma in costume diventa un occhiolino, un saluto con la mano, una testa inclinata e una rotazione: quattro richieste con la stessa immagine e quattro prompt diversi. Poiché l'identità è fissata dal fotogramma, la serie si monta senza che nessuno cambi da una clip all'altra.

Azione ravvicinata e ritmata

L'esempio della forgia resta per sei secondi stretto sul petto e sugli avambracci di un fabbro, illuminati dal basso dal fuoco, con scintille a ogni colpo di martello. Gli impatti ripetuti sono una buona verifica per questo endpoint: le scintille devono comparire sui colpi, non tra un colpo e l'altro.

Consegne verticali

Esporta l'immagine in 9:16 e la clip torna in verticale. Nell'esempio del sottopassaggio il prompt porta solo la camminata verso l'obiettivo sotto le luci al neon e una camera che arretra al suo passo; l'inquadratura verticale è stata decisa nella fase dell'immagine.

Scene senza censura dal tuo fotogramma

La tua immagine viene animata così com'è, senza essere attenuata, e poiché è l'immagine a portare il contenuto, il risultato resta vicino a ciò che è stato approvato. Vidu Q3 Spicy, della stessa linea, è la variante senza censura tarata 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"

Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.