https://api.comfy.org でホスト型の画像モデルとビデオモデルを利用するための単一の API を提供します。Comfy ワークスペースで API キーを作成し、公式の Python および TypeScript SDK か、通常の HTTP 経由で任意のモデルを呼び出せます。課金は従量制です。各リクエストはワークスペースの残高からクレジットを消費し、サブスクリプションはありません。
Higgsfield をお使いですか? ご自身の Higgsfield キーを保存すると、それらの生成は Comfy クレジットではなく Higgsfield アカウントに課金されます。エンドポイントもリクエストボディも同じです。詳細は Higgsfield を自分のキーで使う を参照してください。
LiteLLM で支出を追跡しますか? Router は、LiteLLM が読み取るヘッダーに同期実行の USD コストを報告するため、価格表を維持する必要はありません。詳細は Comfy Router を LiteLLM で使う を参照してください。
APIキーを作成する
Comfy ワークスペースでキーを作成します。Bash 互換のターミナルで次を設定します:API キーはサーバー上またはローカル環境に保管してください。これらの例はターミナルまたはサーバー向けであり、ブラウザの JavaScript 向けではありません。Router はリクエストごとにクレジットを課金します。ワークスペースにクレジット残高がない場合、最初の実際の呼び出しは
402 と error_type: insufficient_credits を返します。このチェックはボディの検証より前に実行されるため、クレジットのないワークスペースでは無効なリクエストでも 402 が返ることがあります。リクエストボディをデバッグする前に、ワークスペースの請求でクレジットを追加してください。リクエストをキューに入れる
使用する言語を選んでサンプルを実行します。生成には数分かかることがあります。SDK の submit 呼び出しはそれぞれ冪等性キーを作成し、自動リトライでそれを再利用します。cURL の例では
uuidgen で作成します。利用できない場合は、別の UUID 生成ツールを使用してください。ステータス、キャンセル、結果の取得の詳細については、キューの配信 を参照してください。画像から動画と参照から動画
同じ Seedance リクエストが画像、動画、音声の入力を受け取ります。content に項目を追加し、それぞれに role を設定します。送信する role が Router の実行する操作を決定します。課金は role ではなく content 内のメディア種別に従います。動画入力が 1 つでもあるリクエストは動画から動画として課金され、そうでなければ画像が 1 つでもあるリクエストは画像から動画として課金され、テキストのみのリクエストはテキストから動画として課金されます。テキストから動画と画像から動画に同じ料金を課すモデルもあります。
画像の
url には公開 URL か data:image/<format>;base64,<content> 文字列を使用できます。送信、ポーリング、収集は上記のクイックスタートとまったく同じです。変わるのはボディだけです。
Image-to-video
Reference-to-video
400 で拒否されるため、ratio を省略するか adaptive を送信してください。リクエストスキーマは Seedance ファミリーで共有されており、モデルが無視する role が含まれることがあるため、各モデルの入力スキーマ の x-comfy-router-input-modalities フィールドで、そのモデルが受け付ける入力種別を確認してください。たとえば、reference_video と reference_audio には、そこで video または audio を列挙しているモデルが必要です。
次のステップ
モデルをブラウズ
利用可能なモデルを確認し、モデル固有のリクエスト例を見つけられます。
Router API の使用
モデルの検出、スキーマ、キュー中のリクエスト、エラー、課金について学びます。