PopNowDocs API
Contenuto principale

Riferimento API di Vidu Q4 Preview

Clip fino al 4K con audio e dialoghi parlati

Con una sola chiave API di PopNow chiami Vidu Q4 Preview 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.75 crediti per secondo generato ($0.0675)
Tempo tipico
circa 160 s

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/q4-preview/image-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 20.000 caratteriDescribe what happens after the opening frame: the action, the dialogue in quotes, the camera and the sound.
image_urlObbligatoriostring (uri)——Opening frame. The clip starts from this image and keeps its shape.
resolutionFacoltativostring720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_secondsFacoltativointeger5da 3 a 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audioFacoltativobooleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
enable_prompt_expansionFacoltativobooleanfalse—Let the model rewrite and expand your prompt before generating.
seedFacoltativointeger—da 0 a 2147483647Random seed for controlled comparisons, not 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/q4-preview/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",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

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"

Da riferimenti a video

vidu/q4-preview/reference-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 20.000 caratteriDescribe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image".
reference_image_urlsObbligatorioarray<string (uri)>—fino a 15 elementiOne to 15 reference images: people, outfits, products or places, in the order your prompt refers to them.
reference_audio_urlsFacoltativoarray<string (uri)>—fino a 3 elementiUp to three reference audio clips (MP3, 3 to 12 seconds each) for a voice or a sound the clip should follow.
aspect_ratioFacoltativostring16:916:9, 9:16, 1:1, 3:4, 4:3Output aspect ratio.
resolutionFacoltativostring720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_secondsFacoltativointeger5da 3 a 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audioFacoltativobooleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
seedFacoltativointeger—da 0 a 2147483647Random seed for controlled comparisons, not 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 reference_image_urls. 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/q4-preview/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

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"

Allunga video

vidu/q4-preview/video-extend

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 20.000 caratteriDescribe what happens next: the action that follows, the camera move and the sound. Put spoken lines in double quotes.
video_urlObbligatoriostring (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.
resolutionFacoltativostring720p540p, 720p, 1080p, 2k, 4kResolution of the generated new segment. It sets how sharp the new part is; match your source clip. 2k and 4k segments come back as 10-bit HEVC.
duration_secondsFacoltativointeger5da 3 a 16Length of the new segment in seconds, from 3 to 16. The source clip is added on top and is not billed.
generate_audioFacoltativobooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionFacoltativobooleanfalse—Let the model rewrite and expand your prompt before generating.
seedFacoltativointeger—da 0 a 2147483647Random 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.

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/q4-preview/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",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

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"

Passi successivi

In questa pagina