PopNowAPI 文档
正文

Wan 2.5 API 调用参考

1080p 带声视频，可以跟着你自己的音频走

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

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

一览

出品方
Alibaba
产出
视频
起价
6.75 积分 每秒成片 ($0.0675)
调用名

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

生成视频

alibaba/wan-2.5/text-to-video

价格

选项积分 (每秒成片)美元
480p6.75$0.0675
720p13.5$0.135
1080p20.25$0.2025

参数

字段类型默认值取值范围作用
prompt必填string—最多 1500 个字符Describe the subject, action, camera, light, pacing, and boundaries for the shot.
negative_prompt可选string—最多 500 个字符List what must not appear in the shot.
aspect_ratio可选string16:916:9, 9:16, 1:1, 4:3, 3:4Output aspect ratio.
resolution可选string720p480p, 720p, 1080pOutput resolution.
duration_seconds可选integer55, 10Requested output length in seconds.
audio_url可选string (uri)——Audio track that drives lip sync or pacing.
enable_prompt_expansion可选booleanfalse—Allow the service to expand the submitted creative brief before generation.
seed可选integer—0 到 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

请求示例

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

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": "alibaba/wan-2.5/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "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"

图生视频

alibaba/wan-2.5/image-to-video

价格

选项积分 (每秒成片)美元
480p6.75$0.0675
720p13.5$0.135
1080p20.25$0.2025

参数

字段类型默认值取值范围作用
image_url必填string (uri)——Opening frame. The clip starts from this image.
prompt可选string—最多 1500 个字符Describe what happens after the opening frame: the action, the camera, and the mood.
negative_prompt可选string—最多 500 个字符List what must not appear in the shot.
resolution可选string720p480p, 720p, 1080pOutput resolution.
duration_seconds可选integer55, 10Requested output length in seconds.
audio_url可选string (uri)——Audio track that drives lip sync or pacing.
enable_prompt_expansion可选booleanfalse—Allow the service to expand the submitted creative brief before generation.
seed可选integer—0 到 2147483647Random seed. Keep it fixed only for controlled comparisons, not as 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": "alibaba/wan-2.5/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"

视频续写

alibaba/wan-2.5/video-extend

价格

选项积分 (每秒成片)美元
480p6.75$0.0675
720p13.5$0.135
1080p20.25$0.2025

参数

字段类型默认值取值范围作用
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.
prompt可选string—最多 1500 个字符Describe what happens next: the action that follows, the camera move and the mood.
negative_prompt可选string—最多 500 个字符List what must not appear in the new segment.
resolution可选string720p480p, 720p, 1080pSharpness of the new segment. Match your source to avoid a visible step in sharpness at the seam.
duration_seconds可选integer55, 10Length of the new segment in seconds. The source clip is added on top and is not billed.
audio_url可选string (uri)——Audio for the new segment: a voice line or music cue it should follow. Your source keeps its own sound.
enable_prompt_expansion可选booleanfalse—Allow the service to expand the submitted creative brief before generation.
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": "alibaba/wan-2.5/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"

接下来

本页内容

一览生成视频图生视频视频续写接下来