Router がサポートするもの
キュー中の送信はありません
Routerはモデルの実行中、接続を保持します。非同期のプロバイダーの場合、ジョブを送信して内部でポーリングします。RouterのジョブID、ステータスエンドポイント、コールバック、ウェブフックは公開していません。 リクエストを必要な時間だけ開いたままにできない場合は、ワーカーからRouterを呼び出し、アプリケーション側でジョブを追跡してください。プロバイダーの送信・ポーリングの制御が必要な場合は、パートナープロキシを使用してください。呼び出しはサーバーの期限で打ち切られる
Router のデフォルトの期限は 10分 で、デプロイメント側で設定できます。クライアントのタイムアウトはそれより長く設定してください。そうすれば Router が先にエラーとリクエスト ID を返せます。504 / deadline_exceeded は Router が待機を停止したことを意味し、504 / provider_timeout はプロバイダーがタイムアウトしたことを意味します。タイムアウトや接続の切断は、生成が課金されなかった証拠にはならず、プロバイダーが受け付けた作業をキャンセルするものでもありません。再試行する前に timeouts and collection を読んでください。
リカバリはプロバイダーに依存する
Router は、承認された送信とポーリング形式の生成に対して、プロバイダーのハンドルを保持できます。同じIdempotency-Key を再利用すると、後でそれを回収できます。完了した再生可能なレスポンスも、キーの記録から取得できます。
切断されたすべての呼び出しがリカバリできるわけではありません。送信する前にリクエストとキーを保存しておき、リトライ結果テーブルを使用してください。新しいキーは新しい呼び出しを作成し、別途課金が発生する可能性があります。
リクエストは呼び出し元ごとにレート制限される
リクエストレートの制限は、呼び出しとカタログ/スキーマの読み取りに適用され、生成前に拒否されたリクエストも含まれます。これはソース IP ではなく、認証された呼び出し元に従います。呼び出し元のプロバイダーキーを使用した呼び出しは対象外ですが、プロバイダーの制限は引き続き適用されます。
カタログとスキーマの読み取りはキャッシュしてください。スキーマは
ETag と If-None-Match で再検証してください。再試行とコミット済み支出のフィールドについてはヘッダーを参照してください。
呼び出し実行中は進捗がありません
Routerは最終的な応答を返し、ストリーミングされるトークン、サーバー送信イベント、進捗率の更新、中間のプレビューフレームはありません。プロバイダーの内部ポーリング状態は、リクエスト中には転送されません。 不確定な進捗インジケーターを表示してください。進捗やストリーミングが必要な場合は、それを公開しているパートナープロキシのオペレーションを使用してください。Comfy の課金と使用量
レスポンスにはプロバイダーの使用量やコストのフィールドが含まれる場合があります。これらは Comfy の一律の課金を表すものではありません。X-Comfy-Credits-Used はオプションであり、リプレイされません。残高、使用量、請求書については Comfy プラットフォームを使用してください。
カタログは価格ではなく、billing.charges_on_policy_rejection などの請求に関する事実を提供します。yes、no、unknown を明示的に処理してください。詳細は billing を参照してください。
Routerはすべてのパートナー操作をカバーしていない
Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、/proxy/… 配下のパートナープロキシルートが必要になる場合があります。Comfy API specification を確認してください。サポートはプロバイダーによって異なります。
モデルの出力と保存されたアセット
入力フィールドと出力フィールドはモデルによって異なります。プロバイダー SDK やプロキシから移行すると、ルートと結果の読み取り方法の両方が変わる可能性があります。 一部のアセットは Comfy ストレージに再ホストされます。その他はプロバイダーの URL またはインラインバイトです。有効期間とリプレイ動作については、結果アセット を参照してください。次のステップ
クイックスタート
Comfy Router を通じて最初の画像を生成します。
Router API の使用
モデルを選択し、そのスキーマを確認して、結果と再試行を処理します。