Introduzione
Vidu Q3 Spicy immagine in video anima un fotogramma iniziale senza censura, con indicazioni di movimento facoltative e audio generato nella stessa passata.
Vidu Q3 Spicy è una build di Vidu Q3 senza censura tarata con LoRA, pubblicata come endpoint immagine in video e video-extend; questa pagina tratta quello immagine in video. Il fotogramma iniziale che fornisci porta il contenuto, il prompt è facoltativo e le clip durano da 1 a 16 secondi a 540p, 720p o 1080p.
Caratteristiche principali
Ciò che approvi è ciò che si anima
L’unico ingresso è un’immagine, quindi non c’è distanza tra la scena che hai approvato e ciò che un prompt di testo è disposto a generare. Abiti, corpo, posa e inquadratura vengono dall’immagine, e il compito del modello è il movimento. I fotogrammi senza censura arrivano così come li hai forniti, senza essere attenuati.
Un’immagine da sola è una richiesta completa
Il prompt è facoltativo. Invia solo il fotogramma e il modello ricava un piccolo movimento credibile, spesso proprio ciò che serve a un loop. Aggiungi testo quando vuoi un momento preciso, come lo sguardo che sale verso la camera o un capo che scivola, e limitati a ciò che cambia invece di descrivere di nuovo l’immagine.
Clip verticali fino a sedici secondi
Non c’è un campo per il formato, quindi un’immagine 9:16 produce una clip 9:16 e niente la reinquadra in uscita. Con un tetto di sedici secondi e 1080p, basta per un momento verticale completo con inizio e fine, non per un frammento di due secondi.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Obbligatorio. È il fermo immagine che si anima: decide il contenuto e la forma dell'output, quindi va sistemato prima di tutto. |
prompt | No | Facoltativo. Descrivi l'azione, la camera e il suono; non ridescrivere il fotogramma. |
duration_seconds | No | Secondi interi, da 1 a 16. Da uno a quattro vanno bene per i loop; sedici coprono un'azione intera. |
resolution | No | 540p, 720p o 1080p. Il valore predefinito è 720p: chiedi 1080p quando consegni. |
movement_amplitude | No | auto, small, medium o large. Auto si regola sul fotogramma iniziale; alzalo quando una scena ferma deve muoversi di più. |
generate_audio | No | Attivo per impostazione predefinita. Mettilo a false per un loop muto. Predefinito: |
bgm | No | Aggiunge musica di sottofondo alla clip. Attivo per impostazione predefinita. Predefinito: |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.0665 / secondo |
| $0.1425 / secondo |
| $0.152 / secondo |
Casi d’uso
Clip senza censura che altre API rifiutano
I fotogrammi vengono accettati senza filtri sui contenuti e animati così come arrivano, quindi il materiale che le API video ospitate rifiutano al filtro dei prompt qui funziona. Poiché il contenuto sta nell’immagine, il risultato corrisponde al fotogramma approvato e non a una reinterpretazione attenuata delle tue parole.
Video di compagnia e di gioco di ruolo
Un’immagine di personaggio diventa una serie di brevi reazioni, uno sguardo verso l’alto, un sorriso, una spalla che si scopre, cambiando solo il prompt. Il fotogramma mantiene stabili identità, costume e set in tutta la serie, ed è questo a far sembrare continuo un feed di compagnia.
Loop verticali per un feed a pagamento
Un’immagine 9:16 si anima in una clip verticale senza reinquadrature, da uno a quattro secondi per un loop o fino a sedici per una scena. Prepara diverse bozze a 540p, poi rigenera a 1080p le due che funzionano meglio.
Consigli avanzati
Prima il fotogramma
Definisci abiti, corpo, posa e inquadratura in una passata d’immagine ed esporta l’immagine nel formato che vuoi consegnare, con un rapporto tra 1:4 e 4:1. Non c’è un campo per correggere il formato dopo: ciò che c’è nell’immagine è ciò che ci sarà nella clip.
Decidi quanto si muove la scena
movement_amplitude accetta auto, small, medium o large. auto si basa sul fotogramma iniziale; alzalo quando una scena ferma deve muoversi di più e abbassalo per un loop in cui deve cambiare solo il respiro. Imposta generate_audio su false per un loop muto.
Adatta l’esempio incluso
L’esempio pubblicato usa duration_seconds 5, generate_audio true e resolution 720p.
She finishes pouring, sets the flask down and lifts her eyes to camera with a small smile, steam rising from the cup, the yukata sliding a fraction lower on her shoulder. Paper shoji glow, evening cicadas, very slow push-in.
Un’immagine più una nota sul movimento: il gesto di versare, lo sguardo in camera e la spalla sono scritti, tutto ciò che identifica la persona viene dal fotogramma.
Bozze economiche, finitura una volta sola
Genera brevi varianti a 540p dallo stesso fotogramma, scegli il movimento che funziona e rigeneralo a 1080p con una durata più lunga per la consegna. La risoluzione è 720p di default, quindi chiedi 1080p in modo esplicito quando consegni.
Avvio rapido dell’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/q3-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"movement_amplitude": "auto",
"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.
