Skip to main content
POST
参考图生视频:参考图/视频保持主体特征创建视频任务
右側 Playground 可直接除錯:在 AuthorizationBearer sk-your-api-key,填好 model / input.media / parameters 後發起請求。提交成功返回 task_id,輪詢與下載見下方說明。
本頁是 wan2.7-r2v(參考圖生影片)的建立介面:給參考圖/參考影片,模型保留其中的主體(人物/動物/物體)和場景特徵,生成單角色表演或多角色互動影片。需要更多參考圖(≤9 張)可考慮 HappyHorse r2v。完整非同步流程見 Wan 概覽
  • 參考素材引用約定:prompt 中用「圖1 / 圖2」指代 reference_image、「影片1 / 影片2」指代 reference_video,順序與 media 陣列一致(圖和影片分別計數)。僅一張圖/一個影片時可簡寫為「參考圖片」「參考影片」。
  • 數量限制reference_image + reference_video 合計 ≤5;first_frame 最多 1 張。
  • 建立請求走 /wan/api/v1/... 並帶 X-DashScope-Async: enable,不要用 /v1/videos

程式碼示例

引數與媒體速查

media[] 取值

響應格式

查詢狀態與下載影片

拿到 task_id 後,按以下三步查詢狀態並下載 mp4:
  • 輪詢 GET /v1/tasks/{task_id}(帶 Authorization,查詢不需要 X-DashScope-Async 頭),每 10 秒一次(不要 < 3 秒),直到 status 變為 completed。參考生影片耗時通常 1–5 分鐘,建議客戶端超時設 20 分鐘兜底。
  • 狀態取值submitted(排隊)/ in_progress(生成中,progress 常停在 30% 屬正常)/ completed(成功)/ failed(失敗,看 error)。
  • 下載:從響應的 result_url 直接 GET,不要帶 Authorization(OSS 簽名直鏈,帶了反而 403);result_url 預設 24 小時過期,務必儘快轉存。
上面是「已有 task_id」的快捷查詢/下載。完整輪詢迴圈(含超時兜底)與 Python 客戶端見 Wan 概覽 · 非同步呼叫流程

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

標頭

X-DashScope-Async
enum<string>
預設值:enable
必填

异步处理开关,必须设置为 enable

可用選項:
enable

主體

application/json
model
enum<string>
預設值:wan2.7-r2v
必填

模型 ID,参考图生视频可填 wan2.7-r2v(历史版本 wan2.6-r2v / wan2.6-r2v-flash)

可用選項:
wan2.7-r2v,
wan2.6-r2v,
wan2.6-r2v-flash
input
object
必填
parameters
object

回應

任务已提交,返回 task_id 与 PENDING 状态

output
object
request_id
string

请求唯一标识

範例:

"..."