Skip to main content
POST
文生视频:根据文本提示词创建视频生成任务
右側 Playground 可直接除錯:在 AuthorizationBearer sk-your-api-key,填好 model / input / parameters 後發起請求。提交成功會返回 task_id,後續輪詢與下載見下方說明。
本頁是 wan2.7-t2v(文生影片)的建立介面。只需一段文本 prompt,無需 media。需要讓圖片動起來或保持主體特徵,請改用 圖生影片 / 參考圖生影片。完整非同步流程、狀態表、Python 客戶端見 Wan 概覽
  • 建立請求必須走 /wan/api/v1/services/aigc/video-generation/video-synthesis 並帶請求頭 X-DashScope-Async: enable不要用 /v1/videos
  • duration 必須是 整數5 不是 "5");resolution大寫 720P

程式碼示例

引數說明速查

響應格式

建立成功返回 task_id不是影片本身):

查詢狀態與下載影片

拿到 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,否则报 current user api does not support synchronous calls

可用選項:
enable

主體

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

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

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

回應

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

output
object
request_id
string

请求唯一标识,排查问题时提供给客服

範例:

"a23b81b0-0c05-9972-a6c9-ee757400afdb"