PopNowAPI 文档
正文

Vidu Q4 Preview API 调用参考

最高 4K 视频，带声音和人物对白

用一个 PopNow API 密钥，就能在自己的代码里调用 Vidu Q4 Preview。下面列出要填的调用名、这个型号接受的每个输入字段、每次请求花多少积分，以及一段可以直接粘进终端运行的请求。

参数说明直接取自型号的输入 schema，暂时只有英文。

一览

出品方
Vidu
产出
视频
起价
6.75 积分 每秒成片 ($0.0675)
一般耗时
约 160 秒
调用名

1 积分 = 0.01 美元。任务受理时先冻结可能的最高费用，完成后按实际用量结算、向上取整到整积分，多冻的退回；失败的任务不扣积分。想在运行前知道确切数字，先调 POST /api/v1/jobs/quote。

图生视频

vidu/q4-preview/image-to-video

价格

选项积分 (每秒成片)美元
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

参数

字段类型默认值取值范围作用
prompt必填string—最多 20000 个字符Describe what happens after the opening frame: the action, the dialogue in quotes, the camera and the sound.
image_url必填string (uri)——Opening frame. The clip starts from this image and keeps its shape.
resolution可选string720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_seconds可选integer53 到 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audio可选booleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
enable_prompt_expansion可选booleanfalse—Let the model rewrite and expand your prompt before generating.
seed可选integer—0 到 2147483647Random seed for controlled comparisons, not a frame-identical guarantee.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 image_url 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

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

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

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"

参考生视频

vidu/q4-preview/reference-to-video

价格

选项积分 (每秒成片)美元
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

参数

字段类型默认值取值范围作用
prompt必填string—最多 20000 个字符Describe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image".
reference_image_urls必填array<string (uri)>—最多 15 项One to 15 reference images: people, outfits, products or places, in the order your prompt refers to them.
reference_audio_urls可选array<string (uri)>—最多 3 项Up to three reference audio clips (MP3, 3 to 12 seconds each) for a voice or a sound the clip should follow.
aspect_ratio可选string16:916:9, 9:16, 1:1, 3:4, 4:3Output aspect ratio.
resolution可选string720p540p, 720p, 1080p, 2k, 4kOutput resolution. 2k and 4k come back as 10-bit HEVC.
duration_seconds可选integer53 到 16Output length in whole seconds, from 3 to 16. Billed per second.
generate_audio可选booleantrue—Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
seed可选integer—0 到 2147483647Random seed for controlled comparisons, not a frame-identical guarantee.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 reference_image_urls 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

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

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

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"

视频续写

vidu/q4-preview/video-extend

价格

选项积分 (每秒成片)美元
540p6.75$0.0675
720p14.25$0.1425
1080p18$0.18
2k28.5$0.285
4k58.5$0.585

参数

字段类型默认值取值范围作用
prompt必填string—最多 20000 个字符Describe what happens next: the action that follows, the camera move and the sound. Put spoken lines in double quotes.
video_url必填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.
resolution可选string720p540p, 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_seconds可选integer53 到 16Length of the new segment in seconds, from 3 to 16. The source clip is added on top and is not billed.
generate_audio可选booleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansion可选booleanfalse—Let the model rewrite and expand your prompt before generating.
seed可选integer—0 到 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 video_url 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

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

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

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"

接下来

本页内容

一览图生视频参考生视频视频续写接下来