Skip to main content
POST
图生视频:首帧图(+ 可选驱动音频)创建视频生成任务
右側 Playground 可直接除錯:在 AuthorizationBearer sk-your-api-key,填好 model / input.media / parameters 後發起請求。提交成功返回 task_id,輪詢與下載見下方說明。
本頁是 wan2.7-i2v(圖生影片)的建立介面:給一張首幀圖 + prompt,讓畫面動起來;可選傳 driving_audio 讓人像跟隨音訊做口型/節奏。完整非同步流程見 Wan 概覽
  • 音訊驅動是 wan2.7-i2v 專屬能力HappyHorse 的 i2v 不支援 driving_audio,做對口型 / rap 必須用 wan2.7-i2v
  • input.media 必填,否則上游報 圖生影片模型 ... 必須提供圖片。媒體 url 必須是公網可直接 GET 的 https 連結。
  • 建立請求走 /wan/api/v1/... 並帶 X-DashScope-Async: enable,不要用 /v1/videos

程式碼示例

引數與媒體速查

media[] 取值

響應格式

查詢狀態與下載影片

拿到 task_id 後,按以下三步查詢狀態並下載 mp4:
  • 輪詢 GET /v1/tasks/{task_id}(帶 Authorization,查詢不需要 X-DashScope-Async 頭),每 5–10 秒一次(不要 < 3 秒),直到 status 變為 completed
  • 狀態取值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-i2v
必填

模型 ID,图生视频固定 wan2.7-i2v(历史版本可填 wan2.6-i2v)

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

回應

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

output
object
request_id
string

请求唯一标识

範例:

"..."