Skip to main content
POST
视频编辑:视频 + 参考图 + 指令创建编辑任务
右側 Playground 可直接除錯:在 AuthorizationBearer sk-your-api-key,填好 model / input.media / parameters 後發起請求。提交成功返回 task_id,輪詢與下載見下方說明。
本頁是 wan2.7-videoedit(影片編輯)的建立介面:給一段影片 + 1–5 張參考圖 + 自然語言編輯指令,對影片元素做換裝、換背景等編輯。注意模型名 無連字元videoedit)。完整非同步流程見 Wan 概覽
  • input.media 必須同時包含 video(被編輯的影片)與至少 1 張 reference_image(參考素材,≤5 張)。
  • 模型名是 wan2.7-videoedit無連字元),與 HappyHorse 的 happyhorse-1.0-video-edit(有連字元)不同,別寫錯。
  • 建立請求走 /wan/api/v1/... 並帶 X-DashScope-Async: enable,不要用 /v1/videos

程式碼示例

引數與媒體速查

media[] 取值

影片編輯的輸出時長跟隨輸入影片,不由 duration 決定,因此本能力通常不傳 duration

響應格式

查詢狀態與下載影片

拿到 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-videoedit
必填

模型 ID,固定 wan2.7-videoedit(无连字符)

可用選項:
wan2.7-videoedit
input
object
必填
parameters
object

回應

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

output
object
request_id
string

请求唯一标识

範例:

"..."