概述
HappyHorse(快馬) 是阿里系影片生成模型系列,主打高度還原的動態畫面生成——精準理解文本語義,輸出流暢自然、細節豐富、主體保持穩定的高品質影片。API易 通過 DashScope 透傳通道 直連,讓你用一個 API易 Key 即可呼叫全部 HappyHorse 能力。當前主力版本 HappyHorse-1.1(影片編輯為 1.0)覆蓋四種核心玩法:🐎 核心亮點:四種能力共用同一個非同步端點和同一套請求結構,切換玩法只改
model 欄位。HappyHorse 偏「高度還原動態畫面」,參考圖生影片支援 最多 9 張參考圖、影片編輯支援 最多 5 張參考圖,主體一致性強。與 Wan 系列 同端點、可直接互換。文生影片 API
happyhorse-1.1-t2v,純文本提示詞生成影片。圖生影片 API
happyhorse-1.1-i2v,首幀圖生成影片(無音訊驅動)。參考圖生影片 API
happyhorse-1.1-r2v,最多 9 張參考圖保持主體。影片編輯 API
happyhorse-1.0-video-edit,最多 5 張參考圖編輯影片。為什麼選 API易 的 HappyHorse
一個 Key 調全部能力
無需註冊阿里雲、無需配置地域。一把 API易 Key 即可呼叫 HappyHorse 全部四種能力以及 Wan 系列。
國內直連 · 免出海
直連
api.apiyi.com,國內機房、家寬網路均可訪問。失敗不計費
任務進入
failed 狀態(媒體 URL 不可達、prompt 涉敏等)不計費,可放心重試。DashScope 協議透傳
與 Wan 系列共用同一端點和 schema,已有 Wan 程式碼切
model 名即可呼叫 HappyHorse。核心特性
四合一非同步端點
t2v / i2v / r2v / video-edit 共用
POST /wan/api/v1/...video-synthesis,提交後返回 task_id,輪詢 + 下載。主體高度還原
模型整體偏「高度還原動態畫面」風格,人物/物體在動態過程中保持得更穩。
最多 9 張參考圖
happyhorse-1.1-r2v 官方支援最多 9 張 reference_image,多參考圖場景的主體一致性更強。多檔解析度與時長
720P / 1080P 解析度,2–15 秒整數時長,
prompt_extend 智慧改寫提升短 prompt 畫質。支援的模型
分組介紹
HappyHorse 與 Wan 兩個系列共用同一個Wan&HappyHorse 分組——一把令牌即可同時呼叫兩個系列。影片模型按秒計費,令牌必須同時滿足兩個條件才能成功路由:
- 計費模式:選「按量優先」或「按量計費」—— 影片按秒計費,按次計費的令牌無法路由
- 分組:選擇包含
Wan&HappyHorse

建立令牌:計費模式選「按量優先」,分組選 Wan&HappyHorse(0.14x),即可呼叫 Wan2.7 與 HappyHorse 全部影片模型(截圖中為分組舊名 Wan,現已更名 Wan&HappyHorse)
模型定價
預設價格 = 阿里雲官方原價的 98%(理解簡單)
API易 系統已內建 HappyHorse 全部模型的價格,無需任何手動配置,通過分組折扣自動生效。控制台裡Wan&HappyHorse 分組顯示倍率 0.14x,這是按人民幣計價單位計的。本站統一用美元充值、固定匯率 1:7,實際折算:
換算公式:本站每秒美元價 = 官方人民幣原價 × 0.14(即 × 0.98 ÷ 7)。
價格明細(預設價,按秒計費)
HappyHorse-1.1 文生 / 圖生 / 參考生影片同價,僅720P / 1080P 兩檔(不支援 480P):
happyhorse-1.0-video-edit(影片編輯)輸出時長跟隨源影片,按實際輸出秒數計費,不由duration決定。- 表中為 預設價(官方 98%);疊加充值加贈最高檔約為表中價 ÷ 1.2(例:1080P 5 秒 $1.12 → 約 $0.93)。
疊加充值加贈,折扣進一步走低
參與 充值加贈活動 後,到賬額度最高可放大約 1.2 倍,等效價格進一步下探:⚠️ 端點選擇(最重要)
API易 同時掛載兩條路徑,只有 DashScope 透傳端點對 HappyHorse 全部能力完整可用:非同步呼叫流程
整套流程是非同步的三步:建立任務 → 輪詢狀態 → 下載影片。1
建立任務
POST /wan/api/v1/services/aigc/video-generation/video-synthesis,請求頭帶 X-DashScope-Async: enable,立刻返回 task_id。2
輪詢狀態
GET /v1/tasks/{task_id}(帶 Authorization),每 5–10 秒查一次(不要小於 3 秒),直到 status 變為 completed。3
下載影片
從響應的
result_url 直接 GET 下載 mp4,不要帶 Authorization 頭(OSS 簽名直鏈,帶 Auth 反而 403)。任務狀態說明
完整 Python 客戶端
關鍵引數詳解
提交時 body 為 DashScope 巢狀結構:{ model, input: { prompt, media[] }, parameters: {...} }。
media[] 型別
parameters 欄位
如何選擇 HappyHorse 還是 Wan
HappyHorse 和 Wan 都是阿里系影片模型、共用同一端點和 schema(只改model 名即可互換),側重不同:
最佳實踐
1
先用 720P / 5 秒聯調
開發期用低解析度短影片快速驗證 prompt 與參考圖效果,定型後再放大解析度與時長。
2
始終開 prompt_extend
prompt_extend: true 對短 prompt 的畫質提升明顯。3
輪詢 5–10 秒一次
不要小於 3 秒(會被限流)。HappyHorse 各能力 720P / 5 秒典型耗時 105–115 秒。
4
客戶端超時設 20 分鐘兜底
1080P 或長影片顯著更慢,給輪詢迴圈設定 20 分鐘兜底超時。
5
拿到 result_url 立即下載落地
result_url 預設 24 小時過期,且是 OSS 簽名直鏈,下載時不要帶 Authorization 頭。錯誤碼與重試
建議客戶端:HTTP 5xx / 網路錯誤做指數退避重試;HTTP 4xx 立刻 surface 不重試;任務
failed 含 [InvalidImageUrl] 可重試,含 [InvalidParameter] / 敏感詞不重試。常見問題
HappyHorse 和 Wan 接入有差別嗎?
HappyHorse 和 Wan 接入有差別嗎?
沒有。兩者共用同一個 DashScope 透傳端點、同一套請求結構、同一組 media type 名、同一個查詢端點。切換隻改
model 欄位(如 wan2.7-t2v → happyhorse-1.1-t2v),body 其餘部分一字不改。HappyHorse 的 i2v 為什麼不能做對口型?
HappyHorse 的 i2v 為什麼不能做對口型?
happyhorse-1.1-i2v 不支援 driving_audio(音訊驅動)欄位,i2v 只接受 first_frame。做對口型 / rap / 數字人口播請用 Wan2.7-i2v。happyhorse-1.1-r2v 真的能塞 9 張參考圖嗎?
happyhorse-1.1-r2v 真的能塞 9 張參考圖嗎?
可以。官方說最多 9 張
reference_image,直接放在 media 數組裡即可。多參考圖能讓主體/服裝/場景一致性更強。為什麼不能用 /v1/videos 提交?
為什麼不能用 /v1/videos 提交?
/v1/videos 對 i2v / r2v 的 media 欄位適配不完整,會導致上游報 [InvalidParameter] Field required: input.media。所有建立請求都走 /wan/api/v1/services/aigc/video-generation/video-synthesis,查詢走 /v1/tasks/{task_id}。result_url 下載報 403 怎麼辦?
result_url 下載報 403 怎麼辦?
去掉
Authorization 頭。result_url 已是 OSS 簽好名的直鏈,再帶 API易 Key 反而被 OSS 拒。result_url 預設 24 小時過期,請儘快下載落地。失敗任務扣費嗎?
失敗任務扣費嗎?
status=failed 不扣費。但重複提交相同任務會重複計費,做好冪等。相關文件
文生影片 Playground
happyhorse-1.1-t2v 線上除錯圖生影片 Playground
happyhorse-1.1-i2v 首幀生成參考圖生影片 Playground
happyhorse-1.1-r2v 最多 9 張參考圖影片編輯 Playground
happyhorse-1.0-video-edit 換裝 / 換背景Wan 系列
同為阿里系,選型對照
HappyHorse 系列通過 API易 DashScope 透傳通道提供。如有問題或建議,歡迎在 API易控制台 工單中反饋。