Happyhorse-1.0 ComfyUI連携

要件とインストール

Happyhorse ComfyUI カスタムノードを、ローカルまたはクラウドの ComfyUI 環境で動作させます。Python 3.10 以上の ComfyUI v1.3+ に対応しています。

pip install comfyui-happyhorse

# 代替案：ComfyUI Manager からインストール
# ComfyUI Manager を開く → Install Custom Nodes → "happyhorse" を検索
# Install をクリック → ComfyUI を再起動

# オプション A：環境変数として設定（推奨）
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"

# オプション B：ノードの api_key フィールドに直接入力
#（キーを埋め込んだ状態でワークフローを共有しないでください）

ワークフローを読み込む

事前に用意されたHappyhorse ComfyUIワークフローのJSONファイルをダウンロードし、ComfyUIのキャンバスに直接ドラッグ＆ドロップするだけで、すぐに始められます。

ダウンロードした.jsonファイルをComfyUIのキャンバスへドラッグするか、［ファイル］→［ワークフローを開く］を使用してください。カスタムノードが正しくインストールされていれば、Happyhorseノードは自動的に読み込まれます。

APIキーの設定

Happyhorse の ComfyUI ノードは内部で Happyhorse REST API を利用しています。APIキーは各動画生成リクエストの認証に使用されます。

# 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
}

出力例

上記のワークフローファイルを使用して、Happyhorse ComfyUI カスタムノードで生成した動画です。Happyhorse-1.0 は、時間的な一貫性とシネマティックなモーション物理を ComfyUI 内で直接実現します。

FAQ

Happyhorse の ComfyUI 連携に関するよくある質問（互換性、API の使い方、トラブルシューティング）です。