PopNowAPI-Doku
Hauptinhalt

Vidu Q4 Preview API-Referenz

Clips bis 4K mit Ton und gesprochenen Dialogen

Mit einem einzigen PopNow-API-Schlüssel rufst du Vidu Q4 Preview aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller
Vidu
Ergebnis
Video
Ab
6.75 Credits pro Sekunde Ergebnis ($0.0675)
Typische Dauer
etwa 160 s

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Bild zu Video

vidu/q4-preview/image-to-video

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 20.000 ZeichenDescribe what happens after the opening frame: the action, the dialogue in quotes, the camera and the sound.
image_urlPflichtstring (uri)——Opening frame. The clip starts from this image and keeps its shape.
resolutionOptionalstring720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_secondsOptionalinteger53 bis 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audioOptionalbooleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
enable_prompt_expansionOptionalbooleanfalse—Let the model rewrite and expand your prompt before generating.
seedOptionalinteger—0 bis 2147483647Random seed for controlled comparisons, not a frame-identical guarantee.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Referenz zu Video

vidu/q4-preview/reference-to-video

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 20.000 ZeichenDescribe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image".
reference_image_urlsPflichtarray<string (uri)>—bis zu 15 EinträgeOne to 15 reference images: people, outfits, products or places, in the order your prompt refers to them.
reference_audio_urlsOptionalarray<string (uri)>—bis zu 3 EinträgeUp to three reference audio clips (MP3, 3 to 12 seconds each) for a voice or a sound the clip should follow.
aspect_ratioOptionalstring16:916:9, 9:16, 1:1, 3:4, 4:3Output aspect ratio.
resolutionOptionalstring720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_secondsOptionalinteger53 bis 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audioOptionalbooleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
seedOptionalinteger—0 bis 2147483647Random seed for controlled comparisons, not a frame-identical guarantee.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in reference_image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Video verlängern

vidu/q4-preview/video-extend

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 20.000 ZeichenDescribe what happens next: the action that follows, the camera move and the sound. Put spoken lines in double quotes.
video_urlPflichtstring (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.
resolutionOptionalstring720p540p, 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_secondsOptionalinteger53 bis 16Length of the new segment in seconds, from 3 to 16. The source clip is added on top and is not billed.
generate_audioOptionalbooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionOptionalbooleanfalse—Let the model rewrite and expand your prompt before generating.
seedOptionalinteger—0 bis 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Weiter geht’s

Auf dieser Seite