API di Vidu Q3: video 1080p con audio

Name: Vidu Q3 API
SKU: vidu/q3/image-to-video
Price: 0.53 USD
Availability: InStock

Parametri della richiesta

Parametro	Obbligatorio	Descrizione
`bgm`	No	Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself. Predefinito: true
`duration_seconds`	No	Quanto dura la clip. Si paga al secondo. ≥ 1 · ≤ 16 · Predefinito: 5
`generate_audio`	No	Aggiunge un audio adatto all'immagine: voci, ambiente ed effetti. Predefinito: true
`image_url`	Sì	L'immagine di partenza.
`movement_amplitude`	No	Quanto si muovono soggetto e camera. auto · small · medium · large · Predefinito: auto
`prompt`	Sì	Describe what happens after the opening frame: the action, the camera, and the mood.
`resolution`	No	Dimensione dell'output. Più grande è più nitido e costa di più. 540p · 720p · 1080p · Predefinito: 720p
`seed`	No	Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647

Prezzi

I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.

Opzione	Crediti al secondo	≈ USD
resolution 540p	10,5	0,11 USD
resolution 720p	22,5	0,23 USD
resolution 1080p	24	0,24 USD

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 53 crediti per una clip di 5 secondi (0,53 USD).

Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.

Guida rapida all'API

Chiama l'API di Vidu Q3 in tre passaggi

Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
Invia la richiesta. Invia POST /jobs/createTask con model vidu/q3/image-to-video e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q3/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.

Domande sull’API di Vidu Q3

Quanto costa l’API di Vidu Q3?

Vidu Q3 costa 53 crediti (0,53 USD) per una clip di 5 secondi. Prezzi per opzione: 540p 10,5 crediti al secondo, 720p 22,5 crediti al secondo, 1080p 24 crediti al secondo. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.

Qual è il nome del modello di Vidu Q3 nell’API?

Inserisci vidu/q3/image-to-video per Da immagine a video nel campo model di POST /jobs/createTask.

Quali risoluzioni supporta Vidu Q3?

540p, 720p e 1080p, con 720p come valore predefinito. Il flusso affidabile è trovare il movimento a 540p, poi rilanciare la ripresa approvata a 1080p con lo stesso fotogramma e lo stesso seed.

Posso generare dal solo testo?

Non in questa famiglia. Vidu Q3 è pubblicato solo come image-to-video, quindi ogni richiesta ha bisogno di image_url. Se parti da un'idea scritta, renderizza prima l'immagine di apertura con un modello di immagini, approvala e poi animala qui.

Come imposto le proporzioni?

Attraverso il fotogramma che carichi. Su questo endpoint non esiste un parametro di proporzioni: un'immagine 16:9 dà una clip 16:9 e un'immagine 9:16 ne dà una verticale, quindi ritaglia l'immagine prima di inviarla.

Genera il suono?

Sì. generate_audio è true per impostazione predefinita, quindi ambiente e foley arrivano in sincrono con l'immagine. Mettilo a false per una clip muta. Sui modelli Q3 non c'è un interruttore separato per una traccia musicale: descrivi nel prompt la musica che vuoi.

Come viene addebitato Vidu Q3?

Per durata dell'output, con la risoluzione come fattore. La stima in tempo reale mostrata prima dell'invio riflette la durata e la risoluzione esatte della tua richiesta.