Comfy RouterでHiggsfield APIキーを使う

ご自身の Higgsfield API キーを Comfy Router に持ち込めます。Higgsfield での生成はお客様自身の Higgsfield アカウントで実行され、そちらに課金されます。Comfy のクレジットには課金されないため、利用量はお客様のアカウントに計上され、Higgsfield が提示する料金やクレジットが適用されます。エンドポイントは1つ、クライアントは1つ、そして Router 上の他のすべてのモデルと同じリクエスト形状をそのまま利用できます。

お客様の Higgsfield 利用に関する料金および利用規約は、お客様自身のアカウント上で Higgsfield が定めるものです。最新の詳細は Higgsfield をご覧ください。

自分のキーを持ち込むと何が変わるか

	自分のComfyキー	自分のHiggsfieldキー
請求先	自分のComfyクレジット	自分のHiggsfieldアカウント
Comfyクレジットの消費	あり	なし
エンドポイント、リクエストボディ、レスポンス	同じ	同じ

呼び出しに関するその他の点はすべて同一です。切り替えるためにコードを変更する必要はありません。キーを保存すれば、Routerがそれを使用します。

Higgsfield APIキーを取得する

Higgsfield APIコンソールでキーを作成します。これは同社のAPI製品です（コンシューマー向けアプリとは別のログインです）。Higgsfieldはこれを idとsecretのペア として発行し、Comfyはそれを単一の文字列 id:secret として保存します。コロンはそのままにし、2つのフィールドに分割しないでください。

Comfyに保存する

ComfyプロフィールでProvider keysを開き、Higgsfield を選択して、id:secret の値を貼り付けます。キーは保存時に暗号化され、一度保存されるとAPIから返されることはありません。Routerはあなた自身の呼び出しに署名するためだけにキーを読み取ります。

Comfy APIキーを作成する

これはComfyに対する認証に使うキーで、Higgsfieldのキーとは別のものです。Comfyワークスペースで作成し、次を設定します。

export COMFY_API_KEY="comfyui-..."

APIキーはサーバーまたはローカル環境に保管してください。これらの例はターミナルまたはサーバー向けであり、ブラウザのJavaScript向けではありません。

モデルを実行する

以下から、選択済みのモデルに対応するコードスニペットをコピーして貼り付けてください。

モデル

Kling 3.0 std
Kling 3.0 プロ
Kling 3.0 4K
Kling 3.0 turbo
Wan 3.0

品質と速度のバランスが取れています。duration は3〜15秒を受け付けます。

curl --max-time 660 \
  https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-std \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5,
    "sound": "on"
  }'

# Python 3.10+
# インストール: python -m pip install "comfy-sdk>=0.3.0"

from comfy_sdk import Comfy

# Comfy は環境変数から COMFY_API_KEY を読み取ります。
with Comfy() as client:
    result = client.models.run(
        "higgsfield/higgsfield-kling-3-std",
        {
            "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
            "duration": 5,
            "aspect_ratio": "16:9",
            "cfg_scale": 0.5,
            "sound": "on",
        },
        timeout=660.0,
    )

print("video:", result["video"]["url"])

// Node.js 22+
// インストール: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx

import { comfy } from "@comfyorg/sdk";

type HiggsfieldResult = { video: { url: string } };

const { data } = await comfy.models.run<HiggsfieldResult>(
  "higgsfield/higgsfield-kling-3-std",
  {
    prompt: "A cinematic glass pavilion in a misty pine forest at sunrise",
    duration: 5,
    aspect_ratio: "16:9",
    cfg_scale: 0.5,
    sound: "on",
  },
  { timeoutMs: 660_000 },
);

console.log("video:", data.video.url);

std よりも高忠実度で、本体は同じです。duration は 3〜15 秒を受け付けます。

curl --max-time 660 \
  https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-pro \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5,
    "sound": "on"
  }'

# Python 3.10+
# インストール: python -m pip install "comfy-sdk>=0.3.0"

from comfy_sdk import Comfy

with Comfy() as client:
    result = client.models.run(
        "higgsfield/higgsfield-kling-3-pro",
        {
            "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
            "duration": 5,
            "aspect_ratio": "16:9",
            "cfg_scale": 0.5,
            "sound": "on",
        },
        timeout=660.0,
    )

print("video:", result["video"]["url"])

// Node.js 22+
// インストール: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx

import { comfy } from "@comfyorg/sdk";

type HiggsfieldResult = { video: { url: string } };

const { data } = await comfy.models.run<HiggsfieldResult>(
  "higgsfield/higgsfield-kling-3-pro",
  {
    prompt: "A cinematic glass pavilion in a misty pine forest at sunrise",
    duration: 5,
    aspect_ratio: "16:9",
    cfg_scale: 0.5,
    sound: "on",
  },
  { timeoutMs: 660_000 },
);

console.log("video:", data.video.url);

4K ティアで、リクエストボディは std および pro と同じです。duration は 3～15 秒を受け付けます。

curl --max-time 660 \
  https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-4k \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5,
    "sound": "on"
  }'

# Python 3.10+
# インストール: python -m pip install "comfy-sdk>=0.3.0"

from comfy_sdk import Comfy

with Comfy() as client:
    result = client.models.run(
        "higgsfield/higgsfield-kling-3-4k",
        {
            "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
            "duration": 5,
            "aspect_ratio": "16:9",
            "cfg_scale": 0.5,
            "sound": "on",
        },
        timeout=660.0,
    )

print("video:", result["video"]["url"])

// Node.js 22+
// インストール: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx

import { comfy } from "@comfyorg/sdk";

type HiggsfieldResult = { video: { url: string } };

const { data } = await comfy.models.run<HiggsfieldResult>(
  "higgsfield/higgsfield-kling-3-4k",
  {
    prompt: "A cinematic glass pavilion in a misty pine forest at sunrise",
    duration: 5,
    aspect_ratio: "16:9",
    cfg_scale: 0.5,
    sound: "on",
  },
  { timeoutMs: 660_000 },
);

console.log("video:", data.video.url);

最速の Kling ティアです。リクエストボディには cfg_scale と sound の代わりに resolution を含めます。duration は 3–15 秒を受け付けます。

curl --max-time 660 \
  https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-turbo \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

# Python 3.10+
# インストール: python -m pip install "comfy-sdk>=0.3.0"

from comfy_sdk import Comfy

with Comfy() as client:
    result = client.models.run(
        "higgsfield/higgsfield-kling-3-turbo",
        {
            "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
            "duration": 5,
            "aspect_ratio": "16:9",
            "resolution": "720p",
        },
        timeout=660.0,
    )

print("video:", result["video"]["url"])

// Node.js 22+
// インストール: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx

import { comfy } from "@comfyorg/sdk";

type HiggsfieldResult = { video: { url: string } };

const { data } = await comfy.models.run<HiggsfieldResult>(
  "higgsfield/higgsfield-kling-3-turbo",
  {
    prompt: "A cinematic glass pavilion in a misty pine forest at sunrise",
    duration: 5,
    aspect_ratio: "16:9",
    resolution: "720p",
  },
  { timeoutMs: 660_000 },
);

console.log("video:", data.video.url);

参照から動画: 参照画像またはクリップを渡し、それらの使用方法を記述します。duration は最大30秒まで受け付けます。

curl --max-time 660 \
  https://api.comfy.org/v2/models/higgsfield/higgsfield-wan-3 \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Use Image 1 for the character and Video 1 for the camera movement",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "video_urls": ["https://cdn.example.com/camera-reference.mp4"],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "adaptive",
    "generate_audio": true
  }'

# Python 3.10+
# インストール: python -m pip install "comfy-sdk>=0.3.0"

from comfy_sdk import Comfy

with Comfy() as client:
    result = client.models.run(
        "higgsfield/higgsfield-wan-3",
        {
            "prompt": "Use Image 1 for the character and Video 1 for the camera movement",
            "image_urls": ["https://cdn.example.com/character.jpg"],
            "video_urls": ["https://cdn.example.com/camera-reference.mp4"],
            "duration": 8,
            "resolution": "1080p",
            "aspect_ratio": "adaptive",
            "generate_audio": True,
        },
        timeout=660.0,
    )

print("video:", result["video"]["url"])

// Node.js 22+
// インストール: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx

import { comfy } from "@comfyorg/sdk";

type HiggsfieldResult = { video: { url: string } };

const { data } = await comfy.models.run<HiggsfieldResult>(
  "higgsfield/higgsfield-wan-3",
  {
    prompt: "Use Image 1 for the character and Video 1 for the camera movement",
    image_urls: ["https://cdn.example.com/character.jpg"],
    video_urls: ["https://cdn.example.com/camera-reference.mp4"],
    duration: 8,
    resolution: "1080p",
    aspect_ratio: "adaptive",
    generate_audio: true,
  },
  { timeoutMs: 660_000 },
);

console.log("video:", data.video.url);

結果の読み取り

run は Higgsfield 自身のターミナルドキュメントを返します。ダウンロード URL は video.url にあります。

{
  "status": "completed",
  "request_id": "0c4a9e17-5b82-4d66-9a3f-7c1e08b45d29",
  "video": { "url": "https://example.com/generated.mp4" }
}

すぐに保存してください。

curl --fail --location "PASTE_VIDEO_URL_HERE" --output out.mp4

Router があなたの代わりに Higgsfield をポーリングするため、queued や in_progress があなたに届くことはありません。完了したドキュメントかエラーを受け取ります。nsfw、failed、canceled はターミナルな失敗であり、failed は error に詳細を含みます。

注意事項

検証は Higgsfield が呼び出される前に実行されます。 公開されている範囲を外れたリクエストボディは、該当するフィールド名とともに 422 で返され、上流には何も送信されません。そのため、不正なリクエストによるコストは一切発生しません。
キーは、そのキーを保有しているモデルにのみ使用されます。 Higgsfield のキーを保存しても、Router 上の他のプロバイダーの課金方法は一切変わりません。
すべてのモデルのリクエストスキーマとレスポンススキーマは、Comfy Router リファレンスに記載されています。

Get Started

Agent Tools

Basic Concepts

Interface Guide

Tutorials

Comfy Cloud Nodes

Partner Nodes

Comfy RouterでHiggsfield APIキーを使う

自分のキーを持ち込むと何が変わるか

モデル

結果の読み取り

注意事項

​自分のキーを持ち込むと何が変わるか

​モデル

​結果の読み取り

​注意事項

自分のキーを持ち込むと何が変わるか

モデル

結果の読み取り

注意事項