Skip to main content
POST
Wan 3.0 全能視頻生成
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。
Wan 3.0 的公共模型名為 wan3.0-video。同一個模型支持以下生成方式:
  • 文生視頻
  • 首幀或首尾幀控制
  • 參考圖片、參考視頻和參考音頻聯合生成
  • 文件或公開網頁內容參考
接口為異步任務。提交成功後返回任務 ID,再通過視頻任務狀態接口查詢進度和結果。
首尾幀模式與參考素材模式互斥。只要請求中包含 first_frame 或 last_frame,就不能同時傳入參考圖片、參考視頻、參考音頻、文件或網頁連結。參考圖片、參考視頻和參考音頻之間可以組合使用。

認證

string
必填
使用 Bearer Token 認證:

請求參數

string
預設值:"wan3.0-video"
必填
模型名稱,固定為 wan3.0-video。
string
視頻內容、主體動作、鏡頭和聲音描述。prompt 與媒體素材至少提供一項。使用多模態參考時,可以按數組順序在提示詞中寫「圖片1」「視頻1」「音頻1」。
integer
預設值:"5"
輸出時長,支持 2 至 30 秒;傳 -1 為智能時長,由模型根據提示詞和素材自動決定輸出長度。
string
預設值:"adaptive"
輸出寬高比,支持:
  • adaptive,根據參考素材自適應
  • 16:9
  • 9:16
  • 1:1
  • 4:3
  • 3:4
兼容字段 aspect_ratio 也可以使用。無需同時傳入兩個字段。
string
預設值:"1080p"
輸出分辨率,支持 480p、720p 和 1080p。
boolean
預設值:true
是否生成音頻,默認開啟。
boolean
預設值:false
是否添加水印,默認關閉。
integer
可選隨機種子。相同參數和種子有助於復現相近結果。
object[]
首尾幀控制數組。每項包含:
  • url:公開可訪問的圖片 URL
  • role:first_frame 或 last_frame
最多提供一個首幀和一個尾幀。使用 last_frame 時必須同時提供 first_frame。
string[]
參考圖片 URL 數組,最多 10 張。不能與 image_with_roles 中的首尾幀混用。
object[]
參考視頻數組,最多 5 段,總時長不超過 15 秒。每項使用以下結構:
object[]
參考音頻數組,最多 5 段,總時長不超過 15 秒。每項包含:
  • url:公開可訪問的音頻 URL
  • role:固定為 reference_audio
object
文件或網頁參考通過 metadata.media 傳入。
本地圖片或視頻需要先上傳並取得公開 URL。不要在生成請求中直接傳入本地文件路徑或 base64 數據。

素材組合規則

如果收到以下錯誤:
請刪除首幀/尾幀,保留參考素材;或者刪除全部參考素材,只保留首幀/尾幀。

請求示例

文生視頻

首尾幀生成視頻

參考視頻生成視頻

不要在此請求中同時傳入 first_frame 或 last_frame。

圖片、視頻和音頻聯合參考

文件參考

響應

string
視頻任務 ID,用於查詢任務狀態。
string
對象類型,通常為 generation.task。
string
本次請求使用的模型名稱。
string
任務狀態:queued、in_progress、completed 或 failed。
integer
任務進度,範圍為 0 至 100。
integer
任務創建時間戳。