HappyHorse 1.0 API

Alibaba HappyHorse 1.0 可透過文字、首格或參考圖片生成 720p 或 1080p 的影片。

預熱官方即時依路由計價資料隱私零資料訓練 API 文件

輸入

prompt*string

描述主體、動態、運鏡、燈光與節奏

route_modestring

選擇此請求使用的提供商路由。

成本較低的官方路由，也是新請求與 API 金鑰的預設選項。

generation_typestring

選取生成工作流程。API 模式將隨此選擇更新。

aspect_ratiostring

生成輸出的外觀比例

預設值："16:9"

resolutionstring

解析度越高，生成所需時間可能越長。

預設值："720p"

durationnumber

生成影片的長度（秒）

輸出

準備進行推論調整輸入內容，然後執行模型。

快速入門

影片 API 參考

建立 API 金鑰
在主控台中建立金鑰，並將其儲存為 MLMUX_API_KEY 環境變數。
建立 API 金鑰
發送請求
將請求發送至 https://api.mlmux.com/v1/videos/generations，並指定模型 ID alibaba/happyhorse-1.0。此範例使用此頁面的預設設定；請視需要變更提示詞與選項。
讀取結果
回應為一個任務。每隔幾秒輪詢其 poll_url 直到 status 變為 succeeded，接著下載影片，或設定 webhook 來接收通知。

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/happyhorse-1.0",
  "route_mode": "official-cheap",
  "prompt": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
  -H "Authorization: Bearer $MLMUX_API_KEY"

範例

查看更多範例 ↗

計費方式

影片依您選擇之解析度的輸出秒數計費。價格隨解析度和路由而異。

深入了解計費方式 ↗

所有影片計費標準

依解析度計算輸出影片每秒費用。計費依據提供商回報的秒數。

解析度	official	official-cheap
720p	$0.138 / 秒	$0.125 / 秒
1080p	$0.246 / 秒	$0.222 / 秒

Readme

HappyHorse 1.0 可透過 MLMux 使用，具備一致的請求格式與兩種明確的路由層級。

三種起始方式

輸入提示詞、讓起始圖片動起來，或使用參考圖片引導片段生成。

720p 或 1080p

片段長度為 3 至 15 秒，解析度為 720p 或 1080p。

選擇 HappyHorse 模型

HappyHorse 1.1 新增了 480p 選項，且 1080p 成本更低；HappyHorse 1.0 Video Edit 則可用於修改現有影片。

常見問題

HappyHorse 1.0 是什麼？

HappyHorse 1.0 是 Alibaba 推出的影片生成模型。在 MLMux 上，你可以直接在瀏覽器中執行，也可以透過一個 API 呼叫。Alibaba HappyHorse 1.0 可透過文字、首格或參考圖片生成 720p 或 1080p 的影片。

如何使用 HappyHorse 1.0 API？

在 MLMux 主控台建立 API 金鑰，然後向 https://api.mlmux.com/v1/videos/generations 發送 POST 請求，在 Authorization 標頭中帶上金鑰，並將 model 設為 alibaba/happyhorse-1.0。請求會傳回一個任務：你可以輪詢它，也可以在影片完成時接收 Webhook 通知。