快樂馬Happyhorse
ComfyUI 官方整合

Happyhorse-1.0 ComfyUI 整合

Happyhorse 官方 ComfyUI 自訂節點——將排名第 1 的影片模型直接串接到你的 ComfyUI 工作流程。三步完成安裝，立刻開始生成電影級 4K 影片。

01pip install
02載入節點
03新增 API 金鑰
API — 即將推出查看方案與價格

需求與安裝

讓 Happyhorse ComfyUI 自訂節點在你的本機或雲端 ComfyUI 環境中運行。支援 ComfyUI v1.3+ 與 Python 3.10+。

需求

  • ComfyUI v1.3.0 或更新版本
  • Python 3.10 或更新版本
  • Happyhorse API 金鑰（註冊即可免費取得）
  • 進行推論 API 呼叫所需的網際網路連線

步驟 1 — 透過 pip 安裝自訂節點

在 ComfyUI 根目錄開啟終端機並執行：

bash
pip install comfyui-happyhorse

步驟 2 — 重新啟動 ComfyUI 並載入節點

安裝完成後，重新啟動 ComfyUI。在節點圖中按右鍵 → 新增節點 → Happyhorse → HappyhorseVideoGenerate。該節點會在你的節點面板中以 Happyhorse 分類顯示。

bash
# Alternatively, install via ComfyUI Manager:
# Open ComfyUI Manager → Install Custom Nodes → search "happyhorse"
# Click Install → Restart ComfyUI

步驟 3 — 輸入你的 API 金鑰

在 HappyhorseVideoGenerate 節點中，將你的 API 金鑰貼到 api_key 欄位，或將其設定為環境變數：

bash
# Option A: set as environment variable (recommended)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"

# Option B: enter directly in the node's api_key field
# (do not share workflows with the key embedded)

載入工作流程

下載我們預先建立的 Happyhorse ComfyUI 工作流程 JSON 檔，直接拖曳到你的 ComfyUI 畫布，即可立即開始使用。

文字轉影片 — 基本版

簡易的文字提示轉影片工作流程。適合作為 Happyhorse ComfyUI 影片生成的入門起點。

happyhorse-t2v-basic.json
文字轉影片 — 進階版

完整參數控制：解析度、動作強度、引導係數、種子。推薦給 Happyhorse 1.0 的 ComfyUI 進階使用者。

happyhorse-t2v-advanced.json
圖片轉影片

上傳參考圖片，透過 ComfyUI 以 Happyhorse-1.0 的動態物理效果進行動畫化。

happyhorse-i2v.json

將下載的 .json 檔拖曳到你的 ComfyUI 畫布上，或使用「檔案 → 開啟工作流程」。若自訂節點已正確安裝，Happyhorse 節點會自動載入。

API 金鑰設定

Happyhorse 的 ComfyUI 節點在背後使用 Happyhorse REST API。你的 API 金鑰會驗證每一次的影片生成請求。

即將推出

Happyhorse API — 即將上線

Happyhorse 公開 API 正在進行最終測試，將在近期正式提供。加入候補名單以取得搶先體驗，並成為第一批將你的 ComfyUI 工作流程連接到 Happyhorse-1.0 的使用者。

加入候補名單

1. 取得你的免費 API 金鑰

前往 Happyhorselab.net 註冊——註冊即贈 10 點免費運算額度，無需信用卡。接著到「Dashboard → API Keys → Create New Key」建立新金鑰。

2. 設定節點

HappyhorseVideoGenerate 節點提供 api_key 輸入欄位。你可以直接輸入金鑰，或使用 ComfyUI 內建的 secret loader 以環境變數方式引用。

json
# In your ComfyUI workflow node:
{
  "api_key": "hh_xxxxxxxxxxxxxxxxxxxx",
  "model": "happyhorse-1.0",
  "prompt": "cinematic aerial shot of mountain peaks at sunrise",
  "resolution": "1280x720",
  "duration": 5,
  "guidance_scale": 7.5,
  "seed": 42
}

3. 監控用量

每次生成都會從你的餘額扣除額度。到「Dashboard → Credits」查看剩餘額度。也可在「Pricing」頁面購買額外運算包，無需訂閱。

加入候補名單 →查看價格方案 →

輸出範例

使用上述工作流程檔案，透過 Happyhorse ComfyUI 自訂節點生成的影片。Happyhorse-1.0 可在 ComfyUI 中直接提供時間一致性與電影級動態物理效果。

Happyhorse-1.0 output

空拍山景片段

“電影感空拍鏡頭：黃金時刻的白雪覆蓋山峰，鏡頭平順漂移，體積雲”

4KT2V風景
Happyhorse-1.0 output

角色特寫

“棚拍柔光下的女性肖像，頭部輕微轉動，擬真膚質細節，淺景深”

1080pT2V人像
Happyhorse-1.0 output

圖轉影示範

“將產品圖片以柔和視差動態與環境光線變化進行動畫化”

720pI2V產品
Happyhorse-1.0 output

抽象動態

“深藍與金色的流體顏料模擬，旋繞的有機紋理，微距鏡頭”

1080pT2V抽象

常見問題

關於 Happyhorse ComfyUI 整合、相容性、API 使用與疑難排解的常見問題。

1

哪些 ComfyUI 版本與 Happyhorse 自訂節點相容？

Happyhorse ComfyUI 自訂節點支援 ComfyUI v1.3.0 以上版本。我們建議使用最新的穩定版。若遇到版本錯誤，請在 ComfyUI 目錄中執行 git pull 升級 ComfyUI，並以 pip install --upgrade comfyui-happyhorse 重新安裝／升級該節點。

2

一次 ComfyUI 影片生成會消耗多少 API 點數？

標準 720p 生成每 5 秒影片消耗 1 點。1080p 與 4K 升級輸出會依動作複雜度以及是否使用 daVinci-MagiHuman 物理引擎而需 2–4 點。你可以在「控制台 → 點數」頁面即時監控用量。

3

安裝後出現「Node not found」錯誤——要怎麼修復？

這通常表示安裝後沒有重新啟動 ComfyUI。請先完全關閉並重新開啟 ComfyUI。若問題仍在，請確認安裝路徑：comfyui-happyhorse 套件應出現在你的 Python 環境 site-packages 之下。可執行 pip show comfyui-happyhorse 進行確認。也請確認你的 Python 版本為 3.10 或以上。

4

沒有網路連線也能使用 Happyhorse ComfyUI 節點嗎？

不行——Happyhorse-1.0 於我們的雲端推論叢集上運行，因此 ComfyUI 節點需要有效的網路連線才能將請求送至 Happyhorse API。目前不支援本機推論。請求內容相對精簡（文字提示或圖片上傳），結果也會以高效率的串流方式回傳。

5

是否有可直接使用的 Happyhorse 圖生影 ComfyUI 工作流程？

有。請在上方的「Workflow」區段下載 happyhorse-i2v.json 工作流程。於 ComfyUI 載入（拖曳到畫布或「File → Open Workflow」），將參考圖片連接到 Image input 節點，加入你的 API 金鑰，然後送出佇列。節點會自動處理編碼與動作合成。

Ready to use Happyhorse-1.0 in ComfyUI?

Get your free API key, download a workflow, and generate your first video in under 5 minutes.

Join API WaitlistView Pricing