Vidu Q3 Turbo API

Vidu Q3 Turbo è il livello rapido della linea Q3 di Vidu ed è disponibile come endpoint da immagine a video e video-extend; questa pagina tratta quello da immagine a video. Un fotogramma iniziale in image_url stabilisce soggetto e forma dell'output, un prompt obbligatorio dirige movimento, camera e suono, e le clip durano da 1 a 16 secondi interi a 540p o 720p, con 720p come predefinito. L'audio viene generato nello stesso passaggio e resta attivo a meno che tu non imposti generate_audio su false. Questo livello è pensato per provare molti movimenti da una sola immagine prima di scegliere la ripresa da consegnare.

Un valore di bozza e uno di consegna

resolution accetta 540p o 720p, e 720p è sia il predefinito sia il massimo di questo endpoint. I due valori lavorano in coppia: 540p per i passaggi in cui il movimento è ancora da decidere, 720p per la ripresa che consegni. Poiché la risoluzione è un solo campo, passare dall'uno all'altro non tocca il prompt, il fotogramma né il seed.

Varianti brevi da un solo fotogramma

La durata va da 1 a 16 secondi interi, e da uno a quattro secondi è l'intervallo pratico per i passaggi di variante. Genera una serie di riprese brevi dalla stessa immagine, ognuna con un solo movimento diverso, e tieni quelle che funzionano invece di scrivere un'istruzione elaborata sperando che vada a segno.

L'immagine stabilisce soggetto e forma

Soggetto, abiti, styling, inquadratura e forma dell'output vengono dall'immagine, non dal prompt, quindi due generazioni dallo stesso fotogramma differiscono nel movimento e non in chi compare sullo schermo. movement_amplitude imposta la quantità complessiva di movimento; che cosa si muove lo decide il prompt. Un testo in contrasto con l'immagine produce una clip che tratta tra i due, quindi tieni il prompt coerente con ciò che mostra il fotogramma.

Serie di reazioni dei personaggi

Un'immagine in costume diventa una riverenza, un occhiolino, un saluto con la mano e una testa inclinata: quattro richieste, lo stesso fotogramma, quattro prompt. Poiché l'immagine fissa l'identità, la serie resta abbastanza coerente da essere montata in un feed.

Tagli quadrati e verticali per i social

La forma dell'output viene dall'immagine, quindi un ritratto 9:16 e un quadrato 1:1 sono due esportazioni della fase dell'immagine, non due impostazioni video diverse. Ognuno si anima in una clip a 720p con il suono già sincronizzato.

Prove di movimento di camera su una sola immagine

L'esempio di push-in richiede un solo movimento e nient'altro: l'inquadratura si stringe gradualmente finché non mostra più che la sua spalla. Usa lo stesso schema per verificare se un soggetto regge mentre l'inquadratura si chiude, prima di scrivere un'istruzione più lunga.

Loop senza censura dalle tue immagini

I fotogrammi di partenza senza censura vengono animati così come sono, e l'intervallo da uno a quattro secondi si presta a costruire una serie di varianti brevi da poche immagini. 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-turbo/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": "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"

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