快樂馬Happyhorse
API — 即將推出

Happyhorse-1.0 API 存取

按量計費 · 無需訂閱 · 可用於你的應用程式

Happyhorse-1.0 REST API 即將推出。目前 Happyhorse API 的直接存取仍在私人預覽中，你現在就可以透過網頁產生影片——同一個模型、同樣品質，只需為實際用量付費。

立即線上使用查看價格

線上使用 Happyhorse-1.0 — 無需 API 金鑰

Happyhorse API 金鑰系統仍在開發中，但模型已可立即使用。購買點數後即可在網站上生成 4K 影片並下載，並包含完整商業授權。待 REST API 上線後，你的點數將自動延續沿用。

01

購買點數

一次性付款，無需訂閱。點數可在網頁版應用、未來的 Happyhorse API 呼叫以及 ComfyUI 節點間通用。

02

生成影片

在 Happyhorse-1.0 Lab 輸入你的提示詞。與未來 REST API 將採用的同一模型 — daVinci-MagiHuman 架構，原生 4K。

03

下載並上線

輸出 MP4，100% 商業 IP 權利歸你所有。待 Happyhorse API 端點上線後，插入你的金鑰即可自動化同一套工作流程。

立即購買點數並生成

API 如何運作

Happyhorse-1.0 REST API 採用簡單的非同步「提交請求－輪詢」模型。使用你的 Happyhorse API 金鑰完成驗證、提交任務，並在結果就緒後取回輸出。以下為 happyhorse-1.0 API 整合的預覽。

01

驗證

在 Authorization 標頭中加入你的 Happyhorse API 金鑰。金鑰會依工作區進行範圍控管，並依方案設定速率限制。

02

提交任務

將你的提示詞與參數以 POST 送至 /v1/generate 端點。Happyhorse API 端點會立即回傳 job_id。

03

輪詢狀態

透過 GET /v1/jobs/{job_id} 檢查進度。當 status 為 completed 時，回應會包含一個有效 24 小時的簽名影片 URL。

04

下載並使用

下載 MP4 輸出或直接串流播放。僅在成功生成時才會扣除點數／額度；失敗的任務永不計費。

curl — 提交影片生成任務

bash
curl -X POST https://api.happyhorselab.net/v1/generate \
  -H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
    "resolution": "4K",
    "duration": 8,
    "motion_strength": 0.7,
    "fps": 24
  }'

Python — 完整整合範例

python
import requests
import time

API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"

# Submit generation job
response = requests.post(
    f"{BASE_URL}/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "prompt": "A lone astronaut walks across a red desert at golden hour",
        "resolution": "4K",
        "duration": 8,
        "motion_strength": 0.7,
        "fps": 24,
    },
)
job_id = response.json()["job_id"]

# Poll until complete
while True:
    status = requests.get(
        f"{BASE_URL}/jobs/{job_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    ).json()
    if status["status"] == "completed":
        print("Video URL:", status["output_url"])
        break
    elif status["status"] == "failed":
        print("Generation failed:", status["error"])
        break
    time.sleep(5)

價格與點數

Happyhorse API 的存取採用與網站相同的點數制度——不需另訂閱、也沒有席位費。你今天購買的點數可用於網頁版，並會在 Happyhorse API 於上線時採用隨用隨付模式後沿用。

標準

每支影片約 ~$0.10 起

1080p，最長 8 秒，標準佇列。適合用於原型開發與評估 Happy Horse AI 影片 API。

Most Popular

專業

每支影片約 ~$0.25 起

原生 4K，最長 16 秒，優先佇列。為正式上線的工作負載打造——可在規模化情境下採用 Happyhorse API 隨用隨付模式。

企業

客製報價

量大折扣、SLA 保障、專屬端點，以及跨團隊的 Happyhorse API 金鑰管理。

在網站購買的點數可與未來的 API 點數完全通用。Happyhorse API 沒有獨立的定價級距——你只需為你實際生成的內容付費。

只要帳戶維持有效，點數永久不會過期。

查看完整價格並購買點數

API 端點（預覽）

Happyhorse-1.0 REST API 提供一組精簡的端點，用於影片生成與工作管理。完整的 happyhorse-1.0 API 文件將於正式上線時發布。

POST/v1/generate

提交文字轉影片或圖片轉影片的生成工作。回傳可用於輪詢的 job_id。

ParameterTypeRequiredDescription
promptstringrequired影片的文字描述。
resolutionstringoptional「1080p」（預設）或「4K」。4K 需要 Pro 點數。
durationintegeroptional影片長度（秒）。範圍：2–16。預設：8。
motion_strengthfloatoptional動作強度 0.0–1.0。預設：0.6。
fpsintegeroptional每秒影格數：24 或 30。預設：24。
seedintegeroptional可重現性種子值。不填則為隨機。
GET/v1/jobs/{job_id}

輪詢生成工作的狀態。完成時回傳 status、progress 與 output_url。

GET/v1/credits

查看剩餘的 happyhorse API 點數餘額與使用紀錄。

GET/v1/models

列出可用模型及其參數範圍。目前僅提供 happyhorse-1.0。

回應範例 — 已完成的工作

json
{
  "job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
  "status": "completed",
  "model": "happyhorse-1.0",
  "created_at": "2025-06-01T14:22:10Z",
  "completed_at": "2025-06-01T14:23:48Z",
  "credits_used": 25,
  "output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
  "output_url_expires_at": "2025-06-02T14:23:48Z",
  "metadata": {
    "resolution": "4K",
    "duration": 8,
    "fps": 24,
    "motion_strength": 0.7
  }
}

常見問題

關於 Happyhorse API 存取、點數與整合的常見問題。

1

如何取得 Happyhorse API 金鑰？

Happyhorse API 金鑰系統目前處於私人預覽階段。期間可先使用 happyhorselab.net 的網頁版應用程式——同一個模型、同等品質。請在定價頁面購買點數後即可立即開始生成。待直連存取正式上線後，儀表板中將提供 API 金鑰。

2

Happyhorse-1.0 API 與 ComfyUI 相容嗎？

相容。官方的 Happyhorse ComfyUI 自訂節點底層使用相同的 REST API。於網頁版購買的點數可與 ComfyUI 整合互通。設定細節請參考我們的 /comfyui 指南。

3

有什麼速率限制？

速率限制會依你的點數方案而定。標準存取將從同時 10 個並行作業、每分鐘 500 次請求起。企業方案可提供自訂限制、專用端點與 SLA 保證——如需 Happyhorse API 企業方案報價，請與我們聯繫。

4

是否提供企業或白標（White-label）API 存取？

有。企業客戶可申請專用推論端點、大量點數套裝、自訂 SLA，以及私有模型微調。請透過定價頁面聯繫，我們將提供量身訂做的方案。

5

Happyhorse API 點數會過期嗎？

在 happyhorselab.net 購買的點數不會過期，前提是你的帳號保持啟用（每 365 天至少登入一次）。無論透過網頁版、API 或 ComfyUI 節點使用，皆適用相同的 Happyhorse API 點數政策。

6

Happyhorse API 支援哪些程式語言？

Happyhorse-1.0 REST API 是標準 HTTP API——任何語言都可使用：Python、Node.js、Go、Ruby、PHP、Java、Rust 等。官方 Python 與 TypeScript SDK 預計在正式上線時提供。在此之前，使用任何 HTTP 用戶端，並在 Authorization 標頭帶上你的 Happyhorse API 金鑰即可。

立即使用排名第一的影片模型開始打造

不用等 API。現在就在線上使用 Happyhorse-1.0，按點數計費；當 REST API 上線時，你的點數餘額將自動延續。

購買點數並立即使用ComfyUI 整合基準測試結果