APIMaster.ai

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.