PopNowAPI ドキュメント
本文

Wan 2.5 API リファレンス

1080pの音声つきクリップ。手持ちの音声に合わせることも

PopNow の API キー 1 つで、Wan 2.5 を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。

パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。

概要

開発元
Alibaba
出力
動画
最安
6.75 クレジット 出力 1 秒あたり ($0.0675)
モデル ID

1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します（整数クレジットに切り上げ、差額は返却）。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。

動画を作成

alibaba/wan-2.5/text-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p6.75$0.0675
720p13.5$0.135
1080p20.25$0.2025

パラメーター

フィールド型既定値指定できる値説明
prompt必須string—1,500 文字まで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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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—1,500 文字まで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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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—1,500 文字まで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"

次に読む

このページの内容

概要動画を作成画像から動画動画を延長次に読む