Skip to Content
模型用法Wan 與 HappyHorse

Wan 與 HappyHorse 系列

阿里巴巴的影片生成模型，共六款，透過 OfoxAI 影片介面 POST /v1/videos 呼叫。任務以非同步方式執行：建立任務後取得任務 ID，再透過該 ID 查詢結果。

模型選擇

重點需要 30 秒時長、480p 或 4:3 畫面比例時選用 Wan 3.0；需要 2 至 3 秒的短影片時，僅阿里系模型支援。
模型解析度（預設）時長畫面比例影片參考
Wan 3.0 Prime480p 720p 1080p（1080p）2–30 秒16:9 4:3 1:1 3:4 9:16 adaptive支援
Wan 3.0480p 720p 1080p（1080p）2–30 秒同上支援
Wan 2.7720p 1080p（1080p）2–15 秒16:9 9:16 1:1支援
Wan 2.6720p 1080p（1080p）2–15 秒16:9 9:16 1:1不支援
HappyHorse 1.0720p 1080p（1080p）3–15 秒16:9 9:16 1:1支援
HappyHorse 1.1720p 1080p（1080p）3–15 秒16:9 9:16 1:1不支援

六款皆支援文生影片與圖生影片，並可生成同步音軌（generate_audio 預設為 true）。adaptive 表示沿用輸入圖片的比例。

模型 ID（呼叫時原樣複製）
Wan 3.0 Primealibaba/wan-3.0-prime30 秒、480p 至 1080p
Wan 3.0alibaba/wan-3.030 秒、480p 至 1080p
Wan 2.7alibaba/wan-2.72 至 15 秒
Wan 2.6alibaba/wan-2.6不支援影片參考
HappyHorse 1.0alibaba/happyhorse-1.03 至 15 秒
HappyHorse 1.1alibaba/happyhorse-1.1不支援影片參考

上表與 Models API 返回的 video_attributes 一致；模型能力如有調整，以介面返回為準。按秒計費，實際費用以任務結果中的 usage.video_cost 為準，價格請參閱模型頁 。

請明確傳入 resolution。 這六款未傳入時皆預設為 1080p，費用按解析度級距計算。用於預覽或社群媒體直式影片時，建議使用 720p 或 480p。

呼叫範例

以下範例只展示建立任務的請求。建立後查詢狀態、下載結果的完整流程見 Video API · 快速開始。

僅傳 prompt。

Terminal
curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "清晨的江南水鄉，小船緩緩划過石橋",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
  • frame_images 與 input_references 不可同時傳入，同時傳入返回 400 references_conflict。
  • 不需要音軌時傳入 "generate_audio": false。
  • 欄位結構的完整說明見建立影片任務。

與其他系列的差異

重點任務提交後無法取消；影片位址為暫時位址，請及時下載。
  • 無法取消：任務提交至上游後，DELETE /v1/videos/{id} 返回 400 cancel_not_supported，任務會繼續生成並計費。提交前請確認參數。
  • 影片位址：實測任務完成後僅返回 unsigned_urls（阿里雲 OSS 暫時位址），不含 mirror_urls。暫時位址可能在 24 小時後失效，請及時下載保存。
  • 更短的時長：Wan 最短 2 秒，HappyHorse 最短 3 秒，其他系列最短為 4 秒。

去浮水印

阿里系模型的專有參數透過 provider.options.dashscope 傳遞：

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options 只會傳給比對到的供應商，其他供應商不會收到。完整說明見影片供應商路由。

常見錯誤

重點參數校驗錯誤在建立時即返回，不會建立任務，也不產生費用。錯誤訊息中會列出允許的取值。
HTTP · code錯誤原文原因處理方法
400 unsupported_parameterduration 31 out of range [2, 30]時長超出該模型範圍Wan 3.0 為 2–30 秒，Wan 2.x 為 2–15 秒，HappyHorse 為 3–15 秒
400 unsupported_parameteraspect_ratio "4:3" not supported; allowed: [16:9 9:16 1:1]Wan 2.x 與 HappyHorse 不支援 4:3、3:4改用 Wan 3.0，或改用支援的比例
400 unsupported_parametermixref2video requests are not supported by this modelWan 2.6、HappyHorse 1.1 不支援影片參考移除 video_url 參考，或改用 Wan 2.7、Wan 3.0、HappyHorse 1.0
400 cancel_not_supportedprovider does not support task cancellation阿里系任務提交後不支援取消任務會繼續執行至完成
400 references_conflictframe_images and input_references are mutually exclusive同時傳入了兩種素材欄位兩者只能擇一
404 model_not_foundmodel not found模型 ID 拼寫錯誤從本頁複製模型 ID

完整錯誤碼見 Video API 錯誤碼。

官方文件

常見問題

Wan 影片最長能生成多少秒？

Wan 3.0 和 Wan 3.0 Prime 單個任務 2 至 30 秒；Wan 2.6、Wan 2.7 為 2 至 15 秒；HappyHorse 1.0、1.1 為 3 至 15 秒。超出範圍返回 400 duration out of range。

Wan 影片怎麼去掉浮水印？

在請求中加入 provider.options.dashscope.watermark: false。provider.options 只會傳給阿里雲百煉（dashscope）這個供應商。

Wan 影片任務可以取消嗎？

不可以。阿里系模型的任務提交到上游後無法中斷，DELETE 會返回 400 cancel_not_supported，任務會繼續生成並計費。提交前請確認參數。

Wan 2.6 報錯 mixref2video requests are not supported by this model？

Wan 2.6 和 HappyHorse 1.1 不支援用影片作為參考。刪除 input_references 中的 video_url，或改用 Wan 2.7、Wan 3.0、HappyHorse 1.0。

Wan 支援 4:3 或 3:4 嗎？

只有 Wan 3.0 和 Wan 3.0 Prime 支援 4:3、3:4 和 adaptive。Wan 2.x 和 HappyHorse 只支援 16:9、9:16、1:1。

Wan 生成的影片位址多久失效？

完成後返回的是 unsigned_urls，即阿里雲 OSS 的暫時位址，可能 24 小時後失效，請及時下載保存。

最後更新於
SeedanceHailuo（MiniMax）