Skip to main content

概述

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 分組——一把令牌即可同時呼叫兩個系列。影片模型按計費,令牌必須同時滿足兩個條件才能成功路由:
  1. 計費模式:選「按量優先」或「按量計費」—— 影片按秒計費,按次計費的令牌無法路由
  2. 分組:選擇包含 Wan&HappyHorse
建立令牌介面:計費模式選「按量優先」,分組下拉中選擇 Wan&HappyHorse(倍率 0.14x),令牌可同時用於 Wan2.7 與 HappyHorse

建立令牌:計費模式選「按量優先」,分組選 Wan&HappyHorse(0.14x),即可呼叫 Wan2.7 與 HappyHorse 全部影片模型(截圖中為分組舊名 Wan,現已更名 Wan&HappyHorse)

模型定價

預設價格 = 阿里雲官方原價的 98%(理解簡單)

API易 系統已內建 HappyHorse 全部模型的價格,無需任何手動配置,通過分組折扣自動生效。控制台裡 Wan&HappyHorse 分組顯示倍率 0.14x,這是按人民幣計價單位計的。本站統一用美元充值、固定匯率 1:7,實際折算:
也就是說,預設價格 = 阿里雲官方原價的 98%(98 折)——比官方直採更省,且無需自建出海鏈路。
換算公式:本站每秒美元價 = 官方人民幣原價 × 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 倍,等效價格進一步下探:
即大客戶最低可做到 官網約 81 折(0.98 ÷ 1.2 ≈ 0.816)。
  • 計費維度 = 解析度檔位 × 時長(秒),失敗任務不計費。
  • 1:7 為固定結算匯率(不是優惠匯率),所有美元充值統一適用。
  • 充值加贈的最高加贈檔位與適用渠道見 充值加贈活動。最新倍率以 控制台 為準。

⚠️ 端點選擇(最重要)

API易 同時掛載兩條路徑,只有 DashScope 透傳端點對 HappyHorse 全部能力完整可用
HappyHorse 與 Wan 共用同一個透傳端點。看到任何文件/示例裡寫 /v1/videos 提交影片任務,直接忽略。所有建立請求都走 /wan/api/v1/...video-synthesis,查詢統一走 /v1/tasks/{task_id}

非同步呼叫流程

整套流程是非同步的三步:建立任務 → 輪詢狀態 → 下載影片
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[] 型別

HappyHorse 的 i2v 不支援 driving_audio(音訊驅動是 Wan2.7-i2v 的專屬能力)。做對口型 / rap 請用 Wan2.7。

parameters 欄位

duration 必須是 整數 5 而不是字串 "5"resolution大寫 720P 更穩。

如何選擇 HappyHorse 還是 Wan

HappyHorse 和 Wan 都是阿里系影片模型、共用同一端點和 schema(只改 model 名即可互換),側重不同:
需要多張參考圖保持主體一致 → 選 happyhorse-1.1-r2v(最多 9 張)。 需要對口型 / rap / 數字人口播 → 選 Wan2.7-i2v(唯一支援音訊驅動)。

最佳實踐

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] / 敏感詞不重試。

常見問題

沒有。兩者共用同一個 DashScope 透傳端點、同一套請求結構、同一組 media type 名、同一個查詢端點。切換隻改 model 欄位(如 wan2.7-t2vhappyhorse-1.1-t2v),body 其餘部分一字不改。
happyhorse-1.1-i2v 不支援 driving_audio(音訊驅動)欄位,i2v 只接受 first_frame。做對口型 / rap / 數字人口播請用 Wan2.7-i2v
可以。官方說最多 9 張 reference_image,直接放在 media 數組裡即可。多參考圖能讓主體/服裝/場景一致性更強。
/v1/videos 對 i2v / r2v 的 media 欄位適配不完整,會導致上游報 [InvalidParameter] Field required: input.media所有建立請求都走 /wan/api/v1/services/aigc/video-generation/video-synthesis,查詢走 /v1/tasks/{task_id}
去掉 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易控制台 工單中反饋。