Riferimento API di Vidu Q3

Con una sola chiave API di PopNow chiami Vidu Q3 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: Vidu
Risultato: Video
Da: 10.5 crediti per secondo generato ($0.105)
ID del modello: vidu/q3/image-to-video

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Da immagine a video

vidu/q3/image-to-video

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`540p`	10.5	$0.105
`720p`	22.5	$0.225
`1080p`	24	$0.24

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`image_url`Obbligatorio	`string (uri)`	—	—	Opening frame. The clip starts from this image.
`prompt`Obbligatorio	`string`	—	—	Describe what happens after the opening frame: the action, the camera, and the mood.
`duration_seconds`Facoltativo	`integer`	`5`	da 1 a 16	Requested output length in seconds.
`resolution`Facoltativo	`string`	`720p`	540p, 720p, 1080p	Output resolution.
`movement_amplitude`Facoltativo	`string`	`auto`	auto, small, medium, large	How much the subject and scene move. Leave it on auto to let the model read the opening frame.
`generate_audio`Facoltativo	`boolean`	`true`	—	Request synchronised output audio.
`bgm`Facoltativo	`boolean`	`true`	—	Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself.
`seed`Facoltativo	`integer`	—	da 0 a 2147483647	Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "vidu/q3/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"