Wan 2.2 Animate API リファレンス
参照動画でキャラクター写真を動かす
PopNow の API キー 1 つで、Wan 2.2 Animate を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。
パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。
概要
- 開発元
- Alibaba
- 出力
- 動画
- 最安
- 7.95 クレジット 出力 1 秒あたり ($0.0795)
- 目安の所要時間
- 約 345 秒
1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します（整数クレジットに切り上げ、差額は返却）。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。
モーションコントロール
alibaba/wan-2.2-animate/character-animation
料金
| オプション | クレジット (出力 1 秒あたり) | 米ドル |
|---|---|---|
480p | 7.95 | $0.0795 |
720p | 16.5 | $0.165 |
パラメーター
| フィールド | 型 | 既定値 | 指定できる値 | 説明 |
|---|---|---|---|---|
image_url必須 | string | — | — | Character image. The person in this image is the one that gets animated. |
video_url必須 | string | — | — | Driving video, 2 to 30 seconds long; upload an MP4, or pass an MP4 or MOV URL. Its motion is transferred to the character and its length sets the output length. Videos outside that range are rejected before any charge. |
animation_mode任意 | string | animate | animate, replace | animate drives the character in the image with the motion of the driving video; replace swaps the person in the driving video for the one in the image. |
resolution任意 | string | 720p | 480p, 720p | Output video resolution. |
prompt任意 | string | — | 2,000 文字まで | Optional description of the motion, used to guide animation style and content. |
seed任意 | integer | — | 0〜2147483647 | Random seed; zero requests a random seed. |
リクエスト例
このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。
例の image_url, video_url には PopNow のサンプル素材を使っています。自分の公開 HTTPS リンク、アップロードしたファイル、保存済みアセットに置き換えてください。
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.2-animate/character-animation",
"input": {
"prompt": "The person dances with relaxed, natural movement",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "720p"
}
}'レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"