Vidu Video Q4 Preview · Riferimento API
Generare un video da una singola immagine o riferimenti, quindi eseguire il sondaggio dell'attività APIMaster.
Utilizzare POST /v1/wand/vidu/image-to-video per una singola immagine iniziale o POST /v1/wand/vidu/reference-to-video per la generazione guidata da riferimento. Sondaggio con GET /v1/wand/vidu/tasks/{task_id}. Utilizzare JSON per l'invio e l'autenticazione Bearer per ogni richiesta. Generazione solo testo e un endpoint start/end-frame separato non sono disponibili per questo modello.
| Campo | Tipo | Descrizione |
|---|---|---|
model |
string | Obbligatorio. Utilizzare vidu-video-q4-preview. |
images |
string[] | Image-to-video richiede esattamente un'immagine. Reference-to-video accetta immagini fino a 15 o subjects. Utilizzare URLs o URI di dati pubblici in PNG, JPEG/JPG o WebP. Il rapporto di aspetto deve essere 1:4 a 4:1. Ogni immagine URL può essere fino a 50 MB. Le immagini Base64 sono limitate a 15 MB prima della codifica e 20 MB codificato in totale. |
subjects |
object[] | Per reference-to-video in alternativa a images. Impostare name di ogni elemento e da uno a tre images. Fare riferimento a un soggetto con @name nel prompt. |
prompt |
string | Richiesto per reference-to-video. Fino a caratteri 2,000 per riferimenti di immagine diretti o 5,000 per soggetti e image-to-video. Image-to-video ignora questo campo quando is_rec è attivo. |
auto_subjects |
boolean | Opzione libreria oggetto per reference-to-video. Valore predefinito: false. |
audio |
boolean | Predefiniti a true per image-to-video e false per reference-to-video. Il video di riferimento con audio richiede subjects e un valore true esplicito. |
audio_type |
string | Quando l'audio è abilitato, utilizzare all (predefinito), speech_only o sound_effect_only. |
is_rec |
boolean | Raccomandazioni rapide automatiche per image-to-video. Abilitarlo aumenta l'utilizzo delle attività. |
duration |
integer | Da 3 a 16 secondi, con 5 come predefinito. |
resolution |
string | 540p, 720p (default), 1080p, 2K o 4K. |
aspect_ratio |
string | Solo Reference-to-video. Utilizzare 16:9 (default), 9:16, 3:4, 4:3 o 1:1. Image-to-video segue l'immagine di input. |
seed |
integer | Ometti il campo o imposta 0 per un seed casuale. |
payload |
string | Dati opzionali dell'applicazione, fino a caratteri 1,048,576. |
watermark |
boolean | Valore predefinito: false. |
wm_url |
string | Filigrana personalizzata opzionale URL. La filigrana predefinita viene visualizzata in alto a sinistra. L'API non accetta wm_position. |
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'
Controlla lo stato ogni 5–10 secondi con il task_id e lo stesso account. Gli stati sono created, queueing, processing, success e failed. In caso di successo, creations[].url è il video e creations[].cover_url è la sua copertina. Scarica i collegamenti temporanei entro le ore 12. Mantenere request_id quando si segnala un errore.
Utilizzare un Idempotency-Key di 8–128 visibile caratteri ASCII per recuperare un invio. La stessa chiave con gli stessi parametri restituisce una ricevuta di recupero con codice HTTP 202. La stessa chiave con parametri diversi restituisce HTTP 409. Vedi Guida al recupero delle richieste. I timeout delle query possono essere riprovati senza creare un nuovo video.
Il gateway stabilisce la generazione una volta. tokenhub_usage.total_tokens segnala l'utilizzo fatturabile. Vedi il Vidu Video Q4 Preview scheda modello per l'attuale APIMaster prezzo.
