請求參數 要求標頭(Headers) Content-Typestring(必選)請求內容類型。此參數必須設定為application/json。Authorizationstring(必選)請求身份認證。介面使用阿里雲百鍊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 (必選)輸入的基本資料。prompt 和 media 必填其一。
prompt string (條件必選)文本提示詞,用來描述期望產生的視頻內容。和 media 必填其一。支援中英文,每個漢字/字母佔一個字元,不超過20000個字元,超過部分會自動截斷。在全能參考模式下,prompt中可以用"圖1""視頻1""音頻1"等指代 media 數組中對應順序的媒體素材。media array (條件必選)媒體素材數組,支援映像、視頻、音頻、檔案和網頁作為輸入。和 prompt 必填其一。
-
數組中每個元素為一個媒體對象,包含
type 與 url 欄位。
-
在參考生視頻模式下,按照數組順序定義
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。
支援輸入的格式:
-
公網URL:
-
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。
支援輸入的格式:
-
公網URL:
傳入音頻(type=reference_audio)
參考音頻URL。音頻限制:
- 格式:wav、mp3。
- 時間長度:單個[1, 15]秒,總時間長度不大於15秒。
- 檔案大小:不超過15MB。
支援輸入的格式:
-
公網URL:
檔案URL。檔案限制:
- 格式:docx、doc、xlsx、xls、pptx、ppt、pdf、txt、key、pages、numbers、md。
- 檔案大小:不超過100MB。
- 頁數限制:不超過50頁(對pdf、docx、doc、pptx、ppt、key、pages格式校正)。
支援輸入的格式:
-
公網URL:
公開網頁的URL地址。僅支援解析無需登入的公開網頁(如新聞、部落格、公眾號等)。支援輸入的格式:
-
公網URL:
parameters object (可選)視頻處理參數。
resolution string (可選)產生視頻的解析度檔位。預設值為 1080P。可選值: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
}
}'
通過 input.media 傳入參考圖片、視頻、音頻、檔案或網頁連結,模型自動理解意圖產生視頻。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": "視頻1抱著圖3,在圖4的椅子上彈奏一支舒緩的鄉村民謠,並說道:"今天的陽光真好。"圖1手中拿著圖2,路過視頻1,把手中的圖2放到視頻1旁邊的桌子上,並說道:"真好聽,能不能再唱一遍"。",
"media": [
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
},
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
僅通過 prompt 產生視頻,不傳入任何媒體檔案。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": "一隻小貓在月光下的屋頂上奔跑,城市的霓虹燈在遠處閃爍,電影級畫質,流暢運鏡。"
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
通過 first_frame 嚴格指定視頻首幀映像。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": "一幅都市奇幻藝術的情境。一個充滿動感的塗鴉藝術角色。一個由噴漆所畫成的少年,正從一面混凝土牆上活過來。他一邊用極快的語速演唱一首英文rap,一邊擺著一個經典的、充滿活力的饒舌歌手姿勢。情境設定在夜晚一個充滿都市感的鐵路橋下。燈光來自一盞孤零零的街燈,營造齣電影般的氛圍,充滿高能量和驚人的細節。視頻的音頻部分完全由rap構成,沒有其他對話或雜音。",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
同時傳入 first_frame 和 last_frame,嚴格指定視頻的首幀和尾幀映像。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": "一個年輕女孩從微笑逐漸層為大笑,鏡頭緩緩推進,背景光線從冷色調漸層為暖色調。",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
},
{
"type": "last_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
通過 reference_video 類型傳入待編輯視頻,結合 prompt 指令編輯視頻內容。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": "將整個畫面轉換為黏土風格",
"media": [
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
}
]
},
"parameters": {
"resolution": "720P",
"prompt_extend": true
}
}'
通過 reference_video 類型傳入原始視頻,結合含延長意圖關鍵詞的 prompt 延長視頻內容。需將 ratio 設為 adaptive。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": "將視頻1向後延長,麵包師端上刷好的麵包,將刷子放到一旁,鏡頭跟隨麵包師,去斜後方的烤爐進行烤制",
"media": [
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
}
]
},
"parameters": {
"resolution": "720P",
"ratio": "adaptive",
"prompt_extend": true
}
}'
|