Alibaba Cloud Model Studio：通義萬相-參考生視頻-API參考

• 基礎能力：支援選擇視頻時間長度（5/10秒）、指定視頻解析度（720P/1080P）、添加浮水印。

• 音頻能力：支援通過提示詞產生聲音，可參考輸入視頻的音色。

• 多鏡頭敘事：支援產生包含多個鏡頭的視頻，並且在鏡頭切換時保持主體一致性。

前提條件

您需要已擷取與配置 API Key並配置API Key到環境變數（準備下線，併入配置 API Key）。

HTTP調用

由於文生視頻任務耗時較長（通常為1-5分鐘），API採用非同步呼叫。整個流程包含 “建立任務 -> 輪詢擷取” 兩個核心步驟，具體如下：

具體耗時受限於排隊任務數和服務執行情況，請在擷取結果時耐心等待。

# 注意：如果使用華北2（北京）地區的模型，需要將url替換為：https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v",
    "input": {
        "prompt": "character1一邊喝奶茶，一邊隨著音樂即興跳舞。",
        "reference_video_urls":["https://cdn.wanxai.com/static/demo-wan26/vace.mp4"]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 5,
        "audio": true,
        "shot_type":"multi"
    }
}'

# 注意：如果使用中國大陸（北京）地區的模型，需要將url替換為：https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v",
    "input": {
        "prompt": "character1對character2說: “I’ll rely on you tomorrow morning!” character2 回答: “You can count on me!”",
        "reference_video_urls": [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251217/dlrrly/%E5%B0%8F%E5%A5%B3%E5%AD%A91%E8%8B%B1%E6%96%872.mp4",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251217/fkxknn/%E9%93%83%E9%93%83.mp4"
        ]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 10,
        "audio": true,
        "shot_type": "multi"
    }
}'

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "caa62a12-8841-41a6-8af2-xxxxxx",
    "output": {
        "task_id": "eff1443c-ccab-4676-aad3-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-16 00:25:59.869",
        "scheduled_time": "2025-12-16 00:25:59.900",
        "end_time": "2025-12-16 00:30:35.396",
        "orig_prompt": "character1在沙發上開心的看電影",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
     "usage": {
        "duration": 10.0,
        "size": "1280*720",
        "input_video_duration": 5,
        "output_video_duration": 5,
        "video_count": 1,
        "SR": 720
    }
}

{
    "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The size is not match xxxxxx"
    }
}

{
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

使用限制

• 資料時效：任務task_id和 視頻url均只保留 24 小時，到期後將無法查詢或下載。

• 內容審核：輸入的 prompt 和輸出的視頻均會經過Alibaba Content Security Service審核，包含違規內容的請求將報錯“IPInfringementSuspect”或“DataInspectionFailed”，具體參見錯誤資訊。

• 網路訪問配置：視頻連結儲存於阿里雲 OSS，如果業務系統因安全性原則無法訪問外部OSS連結，請將以下 OSS 網域名稱加入網路訪問白名單。

  # OSS網域名稱列表
  dashscope-result-bj.oss-cn-beijing.aliyuncs.com
  dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
  dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
  dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
  dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
  dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
  dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
  dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
  dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
  dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

計費與限流

• 模型免費額度和計費單價請參見模型列表與價格。

• 模型限流請參見通義萬相系列。

• 計費說明：

  • 採用 輸入視頻時間長度 + 輸出視頻時間長度 聯合計費，按 視頻秒數 計費。僅當查詢結果介面返回task_status為SUCCEEDED 並成功產生視頻後，才會計費。

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

  計費時間長度的計算規則

  輸入視頻計費時間長度：各參考視頻分別截斷後求和，總輸入計費時間長度不超過 5 秒。

  • 輸入1個參考視頻：輸入計費時間長度=min(視頻時間長度，5s)。

  • 輸入2個參考視頻：輸入計費時間長度=min(視頻1時間長度，2.5s)+ min(視頻2時間長度，2.5s)。

  • 輸入3個參考視頻：輸入計費時間長度=min(視頻1長度，1.65s)+ min(視頻2長度，1.65s)+min(視頻3長度，1.65s)。

  輸出視頻計費時間長度：模型成功產生的視頻秒數。

錯誤碼

如果模型調用失敗並返回報錯資訊，請參見錯誤資訊進行解決。

常見問題

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)