Introduzione
Vidu Q4 Preview Reference to video costruisce una scena da 1 a 15 immagini di riferimento e fino a 3 clip vocali. Vidu Q4 Preview è l'anteprima pubblica del modello video Q4 di Vidu. Le clip durano da 3 a 16 secondi, da 540p a 4k, in cinque proporzioni, con audio generato insieme all'immagine. Questo endpoint è filtrato in modo leggero: dal livello Moderato in su la maggior parte delle richieste viene attenuata o rifiutata.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un fotogramma da animare | Vidu Q4 Preview Image to video |
| persone, abiti, prodotti o luoghi come immagini, con clip vocali facoltativi | Vidu Q4 Preview Reference to video |
Caratteristiche principali
Fino a 15 riferimenti
Persone, abiti, prodotti e luoghi possono entrare insieme. Nelle nostre esecuzioni un volto, un capo e un ambiente sono tornati come un’unica scena.
Due persone, entrambe riconoscibili
Due ritratti come riferimenti hanno mantenuto entrambi i volti nella stessa inquadratura.
Voce di riferimento
Fino a 3 clip audio definiscono la voce. Le parole vengono comunque dal prompt, quindi scrivi la battuta tra virgolette.
Cinque formati e cinque livelli
aspect_ratio offre 16:9, 9:16, 1:1, 3:4 e 4:3; resolution va da 540p a 4k, con il 2k e il 4k in HEVC a 10 bit.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, fino a 20.000 caratteri. Descrivi la scena e richiama i riferimenti per posizione, ad esempio «la donna della prima immagine». almeno 1 caratteri · al massimo 20000 caratteri |
reference_image_urls | Sì | Obbligatorio, da 1 a 15 immagini di persone, abiti, prodotti o luoghi. Una richiesta senza immagini viene respinta. almeno 1 elementi · al massimo 15 elementi |
reference_audio_urls | No | Facoltativo, fino a 3 clip vocali (Vidu chiede MP3, da 3 a 12 secondi ciascuno). almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | 16:9 (predefinito), 9:16, 1:1, 3:4 o 4:3. Non cambia il prezzo. |
resolution | No | 540p, 720p (predefinito), 1080p, 2k o 4k. Determina il prezzo al secondo: il 2k costa più del 1080p e il 4k circa il doppio del 2k. |
duration_seconds | No | Secondi interi, da 3 a 16, predefinito 5. Addebitati al secondo insieme alla risoluzione. |
generate_audio | No | Attivo per impostazione predefinita: dialoghi, effetti e ambiente sonoro sono generati insieme all’immagine. Disattivalo per un clip senza traccia audio. Predefinito: |
seed | No | Mantiene confrontabili le esecuzioni mentre cambi una cosa alla volta. Non promette un clip identico fotogramma per fotogramma. |
Prezzi
Addebito al secondo di output alla risoluzione scelta. Il suono, il numero di immagini di riferimento e il numero di clip audio di riferimento non cambiano il prezzo. Le richieste rifiutate non vengono addebitate.
| Specifiche | Prezzo |
|---|---|
| $0.045 / secondo |
| $0.095 / secondo |
| $0.12 / secondo |
| $0.19 / secondo |
| $0.39 / secondo |
Casi d’uso
Scene di moda e di prodotto
Una modella, un capo e una location in un solo clip.
Inquadrature con due persone
Una conversazione, un arrivo o un quasi bacio con entrambi i volti mantenuti.
Personaggi con la voce
Un ritratto più un clip vocale e una battuta tra virgolette.
Consigli avanzati
Richiama per posizione
Scrivi «la donna della prima immagine» e «la vestaglia della seconda immagine».
Scrivi la battuta
Un clip vocale non fornisce le parole. Metti la battuta tra virgolette e indica che è nella voce dell’audio di riferimento.
Conosci il filtro
Le richieste di livello Lieve sono passate, così come uno dei due prompt di livello Massimo; dal livello Moderato in su, nei nostri test le altre sono state rifiutate o attenuate, e i rifiuti non vengono addebitati. Per scene oltre questi limiti, usa immagine-video partendo da un fotogramma delle persone.
Bozza a 540p
Prova il prompt a 540p, poi rifinisci a 1080p. Scegli il 2k o il 4k solo se riesci a gestire i file HEVC.
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/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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.












