https://api.comfy.org でホスト型の画像モデルとビデオモデルを利用するための単一の API を提供します。Comfy ワークスペースで API キーを作成し、公式の Python および TypeScript SDK か、通常の HTTP 経由で任意のモデルを呼び出せます。課金は従量制です。デフォルトでは、各リクエストがワークスペースの残高からクレジットを消費し、サブスクリプションはありません。料金とその他の課金オプションについては、Router の料金を参照してください。
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 を列挙しているモデルが必要です。
参照ビデオを編集または延長する
Seedance 2.5 では、omni_reference_task_type が参照メディアをどう扱うかをモデルに指示します。reference はそれをガイドとして新しいビデオを作成し、edit は reference_video クリップを変更し、extend はそのクリップを延長します。フィールドがない場合、モデルはプロンプトからタスクを選択します。また、編集はクリップ自体の長さとアスペクト比を維持し、duration と ratio を無視します。BytePlus のネイティブ経路では、リクエストに適合しない明示的な値は生成開始前に拒否されるため、課金されません。フォールバック時に使用されるか、model_provider で選択される代替プロバイダー経路には、タスク種別フィールドがありません。その経路は値を破棄し、フィールドが省略された場合と同様に、そのプロバイダーにタスクを推測させます。この破棄は、同期実行ルートのレスポンスと、キューへの送信の 201 で、X-Comfy-Router-Dropped-Params によって通知されます。キュー経由のルートにはフォールバックがないため、代替経路に到達するのは model_provider を介する場合だけです。
Edit a reference video
"duration": -1 を送信し、ratio を省略してください。extend リクエストは、送信した duration の長さで、新しく生成されたセグメントのみを返します。
次のステップ
モデルをブラウズ
利用可能なモデルを確認し、モデル固有のリクエスト例を見つけられます。
Router API の使用
モデルの検出、スキーマ、キュー中のリクエスト、エラー、課金について学びます。