Skip to main content
萬相

萬相3.0-視頻產生API參考

萬相3.0是全能參考視頻產生模型(All-in-One),統一支援 文生視頻 、 圖生視頻 (首幀/首尾幀)和 參考生視頻 等多種用法。最長可產生30秒視頻,輸出幀率為30fps。

適用範圍

為確保調用成功,請務必保證模型、Endpoint URL 和 API Key 均屬於同一地區。跨地區調用將會失敗。
本文的範例程式碼適用於新加坡地區

HTTP調用

由於視頻產生任務耗時較長(通常為1-5分鐘),API採用非同步呼叫。整個流程包含 "建立任務 -> 輪詢擷取" 兩個核心步驟,具體如下:

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

  • 新加坡
  • 北京
  • 日本(東京)
  • 德國(法蘭克福)
  • 美國(維吉尼亞)
  • 中國香港
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
調用時請將{WorkspaceId}替換為真實的業務空間ID
  • 建立成功後,使用介面返回的 task_id 查詢結果,task_id 有效期間為 24 小時。請勿重複建立任務,輪詢擷取即可。
  • 新手指引請參見Postman

請求參數

要求標頭(Headers)
Content-Typestring(必選)請求內容類型。此參數必須設定為application/jsonAuthorizationstring(必選)請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。樣本值:Bearer sk-xxxx。X-DashScope-Asyncstring(必選)非同步處理配置參數。HTTP請求只支援非同步,必須設定為enable
缺少此要求標頭將報錯:“current user api does not support synchronous calls”。
請求體(Request Body)
model string (必選)模型名稱。可選值:
  • wan3.0-video-prime:高速版,能力對齊標準版,端到端速度顯著提升。
  • wan3.0-video:標準版。
input object (必選)輸入的基本資料。promptmedia 必填其一。

屬性

prompt string (條件必選)文本提示詞,用來描述期望產生的視頻內容。和 media 必填其一。支援中英文,每個漢字/字母佔一個字元,不超過20000個字元,超過部分會自動截斷。在全能參考模式下,prompt中可以用"圖1""視頻1""音頻1"等指代 media 數組中對應順序的媒體素材。media array (條件必選)媒體素材數組,支援映像、視頻、音頻、檔案和網頁作為輸入。和 prompt 必填其一。
  • 數組中每個元素為一個媒體對象,包含 typeurl 欄位。
  • 在參考生視頻模式下,按照數組順序定義 prompt 中素材引用的順序。圖和視頻分別計數,即可同時存在圖1、視頻1。
    • 數組中的第 1 個 reference_video 對應 視頻1,第 2 個對應 視頻2,以此類推。
    • 數組中的第 1 個 reference_image 對應 圖1,第 2 個對應 圖2,以此類推。
    • 數組中的第 1 個 reference_audio 對應 音頻1,第 2 個對應 音頻2,以此類推。

屬性

type string (必選)媒體素材類型。可選值為:
  • first_frame:首幀映像。最多1張,嚴格作為視頻第一幀。
  • last_frame:尾幀映像。最多1張,嚴格作為視頻最後一幀。
  • reference_image:參考映像。最多10張。
  • reference_video:參考視頻。最多5段,總時間長度不大於15秒。
  • reference_audio:參考音頻。最多5段,總時間長度不大於15秒。
  • file:檔案。最多1個,不可與 link 同時輸入。
  • link:網頁連結。最多1個,不可與 file 同時輸入。
reference_xx/file/link 類型和 first_frame/last_frame 類型互斥,不能在同一請求中混用。
url string (必選)媒體素材URL或Base 64 編碼資料。

傳入映像(type=first_frame / last_frame / reference_image)

映像URL或Base 64 編碼資料。映像限制:
  • 格式:JPEG、JPG、PNG(不支援透明通道)、BMP、WEBP。
  • 解析度:單邊[240, 8000]像素。
  • 長寬比:不超過8:1。
  • 檔案大小:不超過20MB。
支援輸入的格式:
  1. 公網URL:
  2. Base 64 編碼映像後的字串:
    • 資料格式:data:{MIME_type};base64,{base64_data}
    • 樣本值:data:image/png;base64,GDU7MtCZzEbTbmRZ......。(編碼字串過長,僅展示片段)
    • 詳情請參見傳入映像

傳入的視訊(type=reference_video)

參考視頻URL。視頻限制:
  • 格式:mp4、mov。
  • 時間長度:單個[1, 15]秒,總時間長度不大於15秒。
  • 幀率:≥16 fps。
  • 解析度:單邊[240, 4096]像素。
  • 長寬比:不超過8:1。
  • 單檔案大小:不超過100MB。
支援輸入的格式:
  1. 公網URL:

傳入音頻(type=reference_audio)

參考音頻URL。音頻限制:
  • 格式:wav、mp3。
  • 時間長度:單個[1, 15]秒,總時間長度不大於15秒。
  • 檔案大小:不超過15MB。
支援輸入的格式:
  1. 公網URL:

傳入檔案(type=file)

檔案URL。檔案限制:
  • 格式:docx、doc、xlsx、xls、pptx、ppt、pdf、txt、key、pages、numbers、md。
  • 檔案大小:不超過100MB。
  • 頁數限制:不超過50頁(對pdf、docx、doc、pptx、ppt、key、pages格式校正)。
支援輸入的格式:
  1. 公網URL:

傳入網頁連結(type=link)

parameters object (可選)視頻處理參數。

屬性

resolution string (可選)產生視頻的解析度檔位。預設值為 1080P。可選值:
  • 1080P
  • 720P
  • 480P
ratio string (可選)產生視頻的寬高比。可選值:
  • adaptive(預設值):自適應長寬比,根據輸入媒體比例和意圖自動推薦合適的長寬比。
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
duration integer (可選)產生視頻的時間長度,單位為秒。預設值為5。
  • 無視頻輸入時:取值範圍為[2, 30]的整數。
  • 有視頻輸入時:輸入視頻總時間長度 + 輸出視頻時間長度不超過30秒。
  • -1 時:智能時間長度模式,模型根據輸入的 prompt、內容和富媒體自動推薦合適時間長度產生。
audio boolean (可選)輸出視頻是否包含音頻。
  • true:預設值,輸出視頻包含聲音。
  • false:輸出視頻不包含音軌。
開關聲音價格相同。seed integer (可選)隨機種子,用於複現產生結果。取值範圍:-1或[0, 2147483647]。傳入-1或未指定時,系統自動產生隨機種子。即使使用相同seed,也不能保證每次產生結果完全一致。prompt_extend boolean (可選)是否開啟prompt智能改寫。開啟後使用大模型對輸入prompt進行智能改寫。對於較短的prompt產生效果提升明顯,但會增加耗時。
  • true:預設值,開啟智能改寫。
  • false:不開啟智能改寫。
watermark boolean (可選)是否添加浮水印標識。
  • false:預設值,不添加浮水印。
  • true:添加浮水印。
  • 參考檔案生視頻
  • 參考生視頻
  • 文生視頻
  • 首幀生視頻
  • 首尾幀生視頻
  • 視頻編輯
  • 視頻延長
通過 file 類型傳入檔案,模型自動理解檔案內容產生視頻。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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": "wan3.0-video",
    "input": {
        "prompt": "一支高端智能眼鏡產品廣告,整體風格極簡、未來感、時尚進階,光影克制,畫面以黑色、銀灰色、冰藍色為主色調,局部點綴柔和白光與參數UI圖形。開場在純黑背景中,一副智能眼鏡從黑暗中緩緩浮現,鏡腿邊緣掠過精緻高光,鏡框輪廓在冷冽邊緣光下被勾勒出來,鏡頭超近距離掠過鏡片、鼻托、轉軸、鏡腿與材質細節,展現金屬與高效能複合材料的細膩質感,表面處理進階克制,線條輕薄流暢。隨後產品在空中緩慢旋轉,畫面以極簡動態圖形同步展示核心參數資訊。隨後鏡頭快速收攏,所有零件精準迴歸組裝成完整產品,切換到年輕模特佩戴展示,模特五官立體、氣質自信,穿著簡潔進階的都市時尚服裝,在極簡空間和城市光影環境中自然轉頭、抬手、行走、微笑,鏡頭從正面、側面、斜後方展示眼鏡佩戴狀態,突出輕薄貼合、時尚輪廓與日常百搭屬性。結尾在純色背景中,產品懸浮定格,鏡頭緩慢推進到品牌logo和核心slogan,整體音樂極簡電子氛圍配合精準鼓點,節奏乾淨有力,畫面質感進階、剋制、純粹,具有強烈品牌記憶點和國際化科技審美。",
        "media": [
            {
                "type": "file",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
            }
        ]
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 10,
        "prompt_extend": true
    }
}'

響應參數

output object任務輸出資訊。

屬性

task_id string任務ID。查詢有效期間24小時。task_status string任務狀態。

枚舉值

  • PENDING:任務排隊中
  • RUNNING:任務處理中
  • SUCCEEDED:任務執行成功
  • FAILED:任務執行失敗
  • CANCELED:任務已取消
  • UNKNOWN:任務不存在或狀態未知
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。codestring請求失敗的錯誤碼。請求成功時不會返回此參數,詳情請參見錯誤碼messagestring請求失敗的詳細資料。請求成功時不會返回此參數,詳情請參見錯誤碼
  • 成功響應
  • 異常響應
請儲存 task_id,用於查詢任務狀態與結果。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

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

  • 新加坡
  • 北京
  • 日本(東京)
  • 德國(法蘭克福)
  • 美國(維吉尼亞)
  • 中國香港
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • 輪詢建議:視頻產生過程約需數分鐘,建議採用輪詢機制,並設定合理的查詢間隔(如 15 秒)來擷取結果。
  • 任務狀態流轉:PENDING(排隊中)→ RUNNING(處理中)→ SUCCEEDED(成功)/ FAILED(失敗)。
  • 結果連結:任務成功後返回視頻連結,有效期間為 24 小時。建議在擷取連結後立即下載並轉存至永久儲存(如阿里雲 OSS)。
  • task_id 有效期間24小時,逾時後將無法查詢結果,介面將返回任務狀態為UNKNOWN

請求參數

要求標頭(Headers)
Authorizationstring(必選)請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。樣本值:Bearer sk-xxxx。
URL路徑參數(Path parameters)
task_id string(必選)任務ID。
  • 查詢任務結果
{task_id}完整替換為上一步介面返回的task_id的值。task_id查詢有效期間為24小時,並請將{WorkspaceId}替換為真實的業務空間ID
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

響應參數

output object任務輸出資訊。

屬性

task_id string(必選)任務ID。task_status string任務狀態。

枚舉值

  • PENDING:任務排隊中
  • RUNNING:任務處理中
  • SUCCEEDED:任務執行成功
  • FAILED:任務執行失敗
  • CANCELED:任務已取消
  • UNKNOWN:任務不存在或狀態未知
submit_time string任務提交時間。時區為UTC+8,格式為 YYYY-MM-DD HH:mm:ss.SSS。scheduled_time string任務執行時間。時區為UTC+8,格式為 YYYY-MM-DD HH:mm:ss.SSS。end_time string任務完成時間。時區為UTC+8,格式為 YYYY-MM-DD HH:mm:ss.SSS。orig_prompt string原始輸入的提示詞。video_url string產生視頻的URL地址。任務成功時返回。codestring請求失敗的錯誤碼。請求成功時不會返回此參數,詳情請參見錯誤碼messagestring請求失敗的詳細資料。請求成功時不會返回此參數,詳情請參見錯誤碼
usage object輸出資訊統計。只對成功的結果計數。

屬性

video_count integer產生視頻的數量。固定為1。duration float產生視頻的時間長度,單位為秒。input_video_duration float輸入視頻的時間長度,單位為秒。無視頻輸入時為0.0。output_video_duration float輸出視頻的時間長度,單位為秒。fps integer產生視頻的幀率。預設值為30。SR integer產生視頻的解析度。樣本值:720。ratio string產生視頻的寬高比。樣本值:16:9。
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。
  • 任務執行成功
  • 任務執行失敗
  • 任務查詢到期
視頻URL僅保留24小時,逾時後會被自動清除,請及時儲存產生的視頻。
{
    "request_id": "78c9b768-0285-996c-b682-xxxxxx",
    "output": {
        "task_id": "17ed7e50-00cf-4509-aea1-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-06 10:01:35.452",
        "scheduled_time": "2026-08-06 10:01:35.507",
        "end_time": "2026-08-06 10:13:33.838",
        "orig_prompt": "A golden retriever running on a sunny beach, waves crashing in the background, cinematic lighting",
        "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/video.mp4"
    },
    "usage": {
        "video_count": 1,
        "duration": 5.0,
        "input_video_duration": 0.0,
        "output_video_duration": 5.0,
        "fps": 30,
        "SR": 720,
        "ratio": "16:9"
    }
}