請求參數 請求頭(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 (必選) 模型名稱。可選值為:
vidu/viduq3-ad_reference2video
vidu/viduq3-drama_reference2video
vidu/viduq3-mix_reference2video
模型選型
- 廣告視訊:推薦 viduq3-ad,面向廣告行業,支援營銷級智能切鏡、運鏡和音效直出,上傳商品圖即可生成廣告視訊。
- 精品劇 / AI 漫劇:推薦 viduq3-drama,角色一致性強、動效細膩、情緒表達真實,適合劇情向內容生產。
- 通用場景:推薦 viduq3-mix,畫面質感與動態效果均衡,適合大多數參考生視訊需求。
input object (必選) 輸入的基本資訊,包括參考圖片和提示詞。 屬性 prompt string (必選) 文本提示詞。用來描述生成視訊中期望包含的元素和視覺特點。 支援中英文,不超過 5000 個字符,超過部分會自動截斷。 示例值:男人坐在靠窗的椅子上,手持吉他,在咖啡廳旁演奏一首舒緩的美國鄉村民謠。 media array (必選) 媒體素材列表,用於指定視訊生成所需的參考圖像。 數組的每個元素為一個媒體對象,包含 type和 url 字段。 元素屬性 type string (必選) 媒體素材類型。可選值與模型有關: 僅傳入參考圖像 支援模型:vidu/viduq3-ad_reference2video、vidu/viduq3-drama_reference2video、vidu/viduq3-mix_reference2video 固定為: 素材限制:圖像數量為1~7張。 url string (必選) 媒體素材URL。素材包括圖像、視訊。 傳入圖像(type=image) 參考圖像URL,必須為公網可訪問的 URL。
- 支援 HTTP 或 HTTPS 協議。
- 示例值:
https://xxx/xxx.png。
圖像限制:
- 格式:JPEG、JPG、PNG、WEBP。
- 寬高比:1:4~4:1。
- 檔案大小:不超過 50MB。
parameters object (必選) 視訊生成參數。如設定視訊解析度、時長等。 屬性 resolution string (可選) 重要resolution直接影響費用,請在呼叫前確認模型價格。 生成視訊的解析度。可選值與模型有關:
- vidu/viduq3-ad_reference2video:可選720P、1080P。預設值為720P。
- vidu/viduq3-drama_reference2video:可選720P、1080P。預設值為1080P。
- vidu/viduq3-mix_reference2video:可選720P、1080P。預設值為720P。
size string (可選) 生成視訊的解析度,格式為宽*高的像素值。 預設值根據resolution而定:
- 當 resolution=720P 時,size 預設為
1280*720。
- 當 resolution=1080P 時,size 預設為
1920*1080。
各模型支援的寬高比有所不同:
- vidu/viduq3-drama_reference2video:僅支援 16:9 和 9:16。
- 其他模型:支援 16:9、4:3、1:1、3:4、9:16。
各解析度檔位對應的 size 取值:
- 720P
- 16:9:
1280*720
- 4:3:
1280*960
- 1:1:
1280*1280
- 3:4:
960*1280
- 9:16:
720*1280
- 1080P
- 16:9:
1920*1080
- 4:3:
1920*1440
- 1:1:
1808*1808
- 3:4:
1440*1920
- 9:16:
1080*1920
duration integer (必選) 重要duration直接影響費用,按秒計費,請在呼叫前確認模型價格。 生成視訊的時長,單位為秒。
-
vidu/viduq3-ad_reference2video:取值為[3, 15]之間的整數。預設值為5。
-
vidu/viduq3-drama_reference2video:取值為[2, 15]之間的整數。預設值為5。
- 當分鏡數量過多或明顯少於duration時,模型可能自動調整時長以保障故事完整性,實際視訊時長可能多於或少於duration設定值。
- 計費按實際輸出時長計算。
-
vidu/viduq3-mix_reference2video:取值為[1, 16]之間的整數。預設值為5。
audio boolean (可選) 支援模型:vidu/viduq3-ad_reference2video、vidu/viduq3-mix_reference2video。 是否生成有聲視訊。開啓後模型將根據視訊內容自動生成匹配的背景音樂或音效。
false:預設值,輸出無聲視訊。
true:輸出有聲視訊。
說明vidu/viduq3-drama_reference2video 不支援該參數,預設輸出有聲視訊。 watermark boolean (可選) 是否添加水印標識,水印位於視訊右下角,文案固定為“內容由AI生成”。
false:預設值,不添加水印。
true:添加水印。
seedinteger(可選) 隨機數種子,取值範圍為[0, 2147483647]。 未指定時,系統自動生成隨機種子。若需提升生成結果的可復現性,建議固定seed值。 請注意,由於模型生成具有概率性,即使使用相同 seed,也不能保證每次生成結果完全一致。 示例值:12345。 | 參考生視訊-廣告(僅參考圖像)支援模型:vidu/viduq3-ad_reference2video。 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": "vidu/viduq3-ad_reference2video",
"input": {
"media": [
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/dtnctw/ad-1.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/bspdpd/ad-2.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/mhsjyy/ad-3.png"
}
],
"prompt": "一个瑜伽裤的广告。商品是一条左右各有一个口袋的黑色高腰瑜伽裤。亚洲模特开心地说"我现在再也不穿没有口袋的瑜伽裤了"。画面保持清晰、稳定、容易理解。"
},
"parameters": {
"duration": 8,
"size": "1080*1920",
"resolution": "1080P",
"watermark": true
}
}'
參考生視訊-短劇(僅參考圖像)支援模型:vidu/viduq3-drama_reference2video。 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": "vidu/viduq3-drama_reference2video",
"input": {
"media": [
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/eelcsu/daram-1.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/adglrn/drama-2.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/fmofkp/drama-3.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260713/mktdht/drama-4.png"
}
],
"prompt": "酒店宴会厅,王桂兰(图3)(在画面右侧,坐在席位上)苏文博(图1)、许向暖(图2)(在画面左侧远处,敬酒中)。婚礼现场座无虚席,坐满宾客。苏文博的母亲王桂兰坐在席位上,眉头紧紧皱起,面露不满。镜头固定,捕捉她皱眉的表情。镜头推进王桂兰面部,她眼神阴沉,嘴角下撇,带着嫌弃和不满。强调她的不悦。"
},
"parameters": {
"duration": 9,
"size": "1080*1920",
"resolution": "1080P",
"watermark": true
}
}'
參考生視訊(僅參考圖像)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": "vidu/viduq3-mix_reference2video",
"input": {
"media": [
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260320/knsple/wan-r2v-role-frame.jpg"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
},
{
"type": "image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
}
],
"prompt": "男人坐在靠窗的椅子上,手持吉他,在咖啡厅旁演奏一首舒缓的美国乡村民谣"
},
"parameters": {
"duration": 5,
"size": "1280*720",
"resolution": "720P",
"watermark": true
}
}'
|