Alibaba Cloud Model Studio：通義萬相-圖生動作API參考

新加坡地區：POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

北京地區：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

步驟1：建立任務擷取任務ID

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.2-animate-move",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

步驟2：根據任務ID查詢結果

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5.2,
        "video_ratio": "standard"
    }
}

{
    "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

wan2.2-animate-move 模型提供標準模式wan-std和專業模式wan-pro兩種服務模式，以滿足不同情境對圖生動作效果的需求。

計費規則

• 計費模式：採用按量後付費模式。按成功產生的視頻秒數計費，計費時間長度以任務成功響應中的 usage.video_duration 欄位為準。

  點擊查看計費樣本

  費用在免費額度耗盡後開始計算。計費公式為：總費用 = 視頻實際產生時間長度 (秒) × 所選服務模式的單價。

  假設您調用新加坡地區的模型產生一個視頻，任務成功後返回的 usage.video_duration 為 5.2 秒，且選擇的是標準模式wan-std。

  費用計算為 5.2 秒 * $0.12/秒 = $0.624

  註：計費時間長度以任務成功後返回的 usage.video_duration 欄位為最終依據。

• 抵扣順序：優先消耗免費額度。額度用盡後，預設轉為隨用隨付。可開啟“免費額度用完即停”功能，以避免免費額度耗盡後產生額外費用。詳情請參見免費額度。

• 調用失敗不計費：模型調用失敗或處理錯誤不產生任何費用，也不消耗免費額度。

限流：主帳號與RAM子帳號合計請求頻率上限為5次/秒，最多有1個任務在處理中，超出限制的新任務將進入排隊隊列。模型限流規則及常見問題，請參見限流。

Q: 如何查看模型調用量？

A: 模型的調用資訊存在小時級延遲，在模型調用完約一小時後，請在模型觀測（新加坡或北京）頁面，查看調用量、調用次數、成功率等指標。如何查看模型調用記錄？

Q: 如何最佳化產生視頻的效果?

A: 可參考以下建議

1. 確保輸入圖片與參考視頻中的人物畫幅佔比相似。

2. 盡量保持圖片和視頻中人物的身材比例一致。

3. 使用高清素材，避免使用模糊圖片和低幀率視頻，確保細節識別準確。

Q: 如何將臨時的視頻連結轉為永久連結？

A: 不能直接轉換該連結。正確的做法是：後端服務擷取到url後，通過代碼下載該視頻檔案，然後將其上傳到永久Object Storage Service服務（如阿里雲 OSS），產生一個新的、永久訪問連結。

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # 設定逾時
        response.raise_for_status() # 如果HTTP狀態代碼不是200，則引發異常
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"視頻已成功下載到: {save_path}")
        # 此處可以接上傳到永久儲存的邏輯
    except requests.exceptions.RequestException as e:
        print(f"下載視頻失敗: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Q: 返回的視頻連結可以在瀏覽器中直接播放嗎？

A: 不建議這樣做，因為連結會在 24 小時後失效。最佳實務是後端下載轉存後，使用永久連結進行視頻播放。