Wan2.2-Animate 圖生動作是做什麼的？

把參考影片裡的動作+表情遷移到一張靜態人物圖上，生成動態影片。走阿里雲百煉 API，模型名固定 wan2.2-animate-move。

前置檢查（每次都先做）

本技能需要阿里雲百煉 API Key。先把工作目錄切到本 SKILL.md 所在目錄，然後跑：

python scripts/wan_animate.py check

若該路徑報「找不到檔案」，改用技能目錄的絕對路徑重試（把 scripts/wan_animate.py 換成 <技能目錄>/scripts/wan_animate.py）。不要因為找不到腳本就放棄或改用別的方式自己寫請求。

輸出 "api_key_set": true → 直接繼續。
輸出 false → 停下來問使用者要 API Key，不要自己去猜或寫死。告知使用者去阿里雲百煉控制檯建立，並設定環境變數：

# Windows PowerShell
$env:DASHSCOPE_API_KEY="sk-xxxx"
# macOS / Linux
export DASHSCOPE_API_KEY=sk-xxxx

**不要把使用者的 API Key 寫進任何檔案、筆記或對話總結。**只在當前工作階段用環境變數傳遞。

如果使用者希望用業務空間專屬域名（更快更穩），讓使用者提供後設定 DASHSCOPE_API_HOST： https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com 或新加坡地域
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com。注意北京和新加坡的 API Key 不通用。

執行

python scripts/wan_animate.py run \
  --image <角色圖片路徑或URL> \
  --video <參考影片路徑或URL> \
  --mode wan-std \
  --out ./output

參數說明：

參數	說明
`--image`	必填。角色圖片，本地路徑或公網 URL 都可以，本地檔案由腳本自動上傳到百煉暫存
`--video`	必填。參考影片，同上。時長 2~30 秒
`--mode`	`wan-std` 標準模式，快、便宜，預設用它；`wan-pro` 專業模式，畫面更流暢但更慢更貴
`--watermark`	加「AI生成」浮水印，預設不加
`--out`	輸出目錄，預設 `./wan_animate_output`
`--no-download`	只回傳結果連結，不落盤。結果連結 24 小時有效，通常還是下載到本地更好

腳本會自動完成：上傳本地素材 → 建立非同步任務 → 每 15 秒輪詢 → 下載成品到本地。單支影片通常要等幾分鐘，這是正常的，別中途報錯，讓輪詢跑完。最終會從 RESULT_JSON_BEGIN / RESULT_JSON_END 之間輸出結果 JSON，把裡面的影片路徑告訴使用者。

素材限制（提交前先檢查，能省一輪失敗）

圖片：JPG/JPEG/PNG/BMP/WEBP，寬高都在 200~4096 px，寬高比 1:3 ~ 3:1，≤ 5MB
影片：MP4/AVI/MOV，時長 2~30 秒，寬高都在 200~2048 px，寬高比 1:3 ~ 3:1，≤ 200MB
兩張素材必須是公網可訪問 URL 或本地檔案。普通網址若需要登入/防盜鏈會失敗，這種情況先讓使用者把檔案下載到本地再走本地路徑

超出限制就在呼叫前告訴使用者並說明要怎麼處理（裁剪、壓縮、轉碼），不要硬著頭皮提交。

效果最佳化（出圖差時先排查這幾條）

圖片和參考影片裡的人物畫面佔比要接近 —— 一個全身一個半身基本必翻車
兩者的人物身材比例要一致
參考影片解析度和幀率越高越好，糊影片會直接拉低成品畫質
第一次嘗試用 wan-std 驗動作是否對齊，確認滿意後再用 wan-pro 出終版 —— pro 模式貴，別上來就燒錢

常見錯誤處理

腳本會把百煉的錯誤碼翻譯成人話，你只需要轉述給使用者：

UrlOrFileNotReachable / downloadFail → 連結不通或有鑑權，改走本地檔案上傳
DataInspectionFailed / IPInfringementSuspect → 素材沒過內容稽核或疑似侵權，換素材
Arrearage / FreeQuotaExhausted → 帳號欠費或免費額度用完，需要儲值/開通付費
InvalidApiKey → Key 失效，讓使用者重新產生
Throttling → 觸發限流，稍等重試
InvalidParameter → 素材尺寸/時長不合規，對照上面的限制檢查

計費口徑：**輸入不計費，按成功產生的影片秒數計費，呼叫失敗不扣費。**具體單價以百煉控制檯為準，使用者問起時讓他去看「模型價格」頁，不要憑記憶報價。

如果使用者還沒提供素材，先問清楚圖片和影片在哪，別編造檔案路徑。

Wan2.2-Animate 圖生動作