PopNowAPI 文件
主要內容

Wan 2.2 Animate API 呼叫參考

用參考影片帶動一張角色照片

只要一把 PopNow API 金鑰,就能在自己的程式裡呼叫 Wan 2.2 Animate。以下列出要填的呼叫名稱、這個型號接受的每個輸入欄位、每次請求花多少點數,以及一段可以直接貼進終端機執行的請求。

參數說明直接取自型號的輸入 schema,目前只有英文。

總覽

開發商
Alibaba
產出
影片
起價
7.95 點 每秒成片 ($0.0795)
一般耗時
約 345 秒

1 點 = 0.01 美元。任務受理時會先保留可能的最高費用,完成後依實際用量結算、無條件進位到整點,多保留的會退回;失敗的任務不扣點數。想在執行前知道確切數字,請先呼叫 POST /api/v1/jobs/quote。

動作控制

alibaba/wan-2.2-animate/character-animation

價格

選項點數 (每秒成片)美元
480p7.95$0.0795
720p16.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選填stringanimateanimate, replaceanimate 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選填string720p480p, 720pOutput video resolution.
prompt選填string—最多 2000 個字元Optional description of the motion, used to guide animation style and content.
seed選填integer—0 到 2147483647Random seed; zero requests a random seed.

請求範例

這段請求原樣就能執行,沒寫的欄位都用預設值。執行前請先把金鑰放進環境變數 POPNOW_API_KEY。

範例中的 image_url, 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.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 等候通知。

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"

接下來

本頁內容