APIMaster.ai

Vidu Image Q2 · Riferimento API

Genera immagini con Vidu Image Q2 da testo o immagini di riferimento. Controlla le attività e scarica i risultati.

Creare un'attività con POST /v1/wand/vidu-image/generation e interrogarla con GET /v1/wand/vidu-image/tasks/{task_id}. Inviare una chiave API APIMaster nell'intestazione Authorization: Bearer con entrambe le richieste. Il corpo della richiesta POST è in formato JSON.

Campo Tipo Descrizione
model string Obbligatorio. Utilizzare vidu-image-q2.
prompt string Obbligatorio. Fino a 2,000 caratteri. Per generare immagini dal solo testo, ometti le immagini di riferimento (text-to-image).
images string[] Facoltativo. Fino a sette URL pubblici o URI di dati in formato PNG, JPEG/JPG o WebP. Ogni immagine deve misurare almeno 128 × 128 pixel, con proporzioni tra 1:4 e 4:1 e una dimensione massima di 50 MB. Il corpo della richiesta può occupare fino a 20 MB.
aspect_ratio string 16:9 di default. Le opzioni sono 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 e auto. L'impostazione auto segue la prima immagine di riferimento.
resolution string 1080p di default. Supporta anche 2K e 4K. I valori distinguono tra maiuscole e minuscole.
seed integer Ometti il campo o imposta 0 per un seed casuale.
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'

Controlla lo stato ogni 3–5 secondi con il task_id restituito e lo stesso account. Gli stati possibili sono created, queueing, processing, success e failed. In caso di successo, scaricare i file sotto creations[].url entro le ore 12. Utilizzare request_id per tracciare errori come immagini non valide, revisione dei contenuti, credito insufficiente, limiti di tariffa o attività mancanti.

Consultare lo stato non crea una nuova generazione e non comporta un altro addebito. callback_url non è supportato. Per recuperare una presentazione persa, inviare una stable Idempotency-Key di 8–128 visibile ASCII personaggi e seguire il Guida al recupero delle richieste. 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.

tokenhub_usage.total_tokens riporta l'utilizzo fatturabile, che dipende dalla risoluzione e dal numero di riferimenti utilizzati. Vedi il Vidu Image Q2 scheda modello per l'attuale APIMaster prezzo.