Riferimento API di Vidu Q3 Turbo
Animazione rapida di immagini con audio, fino a 16 secondi
Con una sola chiave API di PopNow chiami Vidu Q3 Turbo 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
- 6.3 crediti per secondo generato ($0.063)
- Tempo tipico
- circa 35 s
- ID del modello
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-turbo/image-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
540p | 6.3 | $0.063 |
720p | 9.9 | $0.099 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
image_urlObbligatorio | string (uri) | — | — | Opening frame. The clip starts from this image. |
promptObbligatorio | string | — | — | Describe what happens after the opening frame: the action, the camera, and the mood. |
movement_amplitudeFacoltativo | string | auto | auto, small, medium, large | How much things in the frame move. |
duration_secondsFacoltativo | integer | 5 | da 1 a 16 | Requested output length in seconds. |
resolutionFacoltativo | string | 720p | 540p, 720p | Output resolution. |
generate_audioFacoltativo | boolean | true | — | Request synchronised output audio. |
bgmFacoltativo | boolean | true | — | Add a background music bed that fits the scene. |
seedFacoltativo | 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.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "vidu/q3-turbo/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.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Allunga video
vidu/q3-turbo/video-extend
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
540p | 6.3 | $0.063 |
720p | 9.9 | $0.099 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
video_urlObbligatorio | string (uri) | — | — | The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on. |
promptObbligatorio | string | — | — | Describe what happens next: the action that follows, the camera move and the sound. |
movement_amplitudeFacoltativo | string | auto | auto, small, medium, large | How much things in the new segment move. |
duration_secondsFacoltativo | integer | 5 | da 1 a 16 | Length of the new segment in seconds, from 1 to 16. The source clip is added on top and is not billed. |
resolutionFacoltativo | string | 720p | 540p, 720p | Resolution of the generated new segment. It sets how sharp the new part is; match your source clip. |
generate_audioFacoltativo | boolean | true | — | Generate sound for the new segment. The source keeps its own sound either way. |
bgmFacoltativo | boolean | true | — | Add a background music bed to the new segment. The source keeps its own sound. |
seedFacoltativo | 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 video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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-turbo/video-extend",
"input": {
"prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"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.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"