> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Router の制限事項

> Comfy Router が現在できないこと、代替手段が存在する場合に代わりに使用すべきもの、およびこれらの制限のうち変更される見込みのあるものについて説明します。

Router はパートナーモデルを1回の同期 HTTP 呼び出しで実行します。アプリケーションが完了した結果を待つことができ、モデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。

## Router がサポートするもの

| 要件               | Router のサポート                                          | 代替案または次のステップ                                                                           |
| ---------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 1回のリクエストで生成      | `POST /v2/models/{provider}/{model}` が完了した結果を返します。    | [クイックスタート](/ja/development/comfy-router/quickstart)から始めてください。                          |
| ジョブを送信して後で受け取る   | 一般的なジョブ/ステータス API や完了 webhook はありません。                 | ワーカーから Router を実行するか、送信とポーリングの操作に対応したパートナープロキシを使用してください。                               |
| 進捗の表示や出力のストリーミング | 呼び出し中にライブ進捗、ストリーミング、プレビューフレームはありません。                  | 不確定な状態を表示するか、サポートされているプロキシ操作を使用してください。                                                 |
| 接続が失われた後の復旧      | Router が受け付けた生成のハンドルを保持していた場合、同じキーでの収集が可能です。          | キーを保持し、[再試行ガイダンス](/ja/development/comfy-router/api#retry-outcomes)に従ってください。            |
| Comfy の課金を照合する   | レスポンスに汎用的な Comfy のコストやクレジット残高のフィールドはありません。            | [ワークスペースの請求](https://platform.comfy.org)を使用してください。                                     |
| 結果を永続的に保存する      | 再ホストされた URL や再生された URL を含め、アセット URL は期限切れになる可能性があります。 | アセットをダウンロードしてください。詳細は[結果アセット](/ja/development/comfy-router/reference#結果アセット)を参照してください。 |

## キュー中の送信はありません

Routerはモデルの実行中、接続を保持します。非同期のプロバイダーの場合、ジョブを送信して内部でポーリングします。RouterのジョブID、ステータスエンドポイント、コールバック、ウェブフックは公開していません。

リクエストを必要な時間だけ開いたままにできない場合は、ワーカーからRouterを呼び出し、アプリケーション側でジョブを追跡してください。プロバイダーの送信・ポーリングの制御が必要な場合は、[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)を使用してください。

## 呼び出しはサーバーの期限で打ち切られる

Router のデフォルトの期限は **10分** で、デプロイメント側で設定できます。クライアントのタイムアウトはそれより長く設定してください。そうすれば Router が先にエラーとリクエスト ID を返せます。

`504` / `deadline_exceeded` は Router が待機を停止したことを意味し、`504` / `provider_timeout` はプロバイダーがタイムアウトしたことを意味します。タイムアウトや接続の切断は、生成が課金されなかった証拠にはならず、プロバイダーが受け付けた作業をキャンセルするものでもありません。再試行する前に [timeouts and collection](/ja/development/comfy-router/api#timeouts-and-collection) を読んでください。

<span id="no-way-to-resume-a-call-you-lost" />

## リカバリはプロバイダーに依存する

Router は、承認された送信とポーリング形式の生成に対して、プロバイダーのハンドルを保持できます。同じ `Idempotency-Key` を再利用すると、後でそれを回収できます。完了した再生可能なレスポンスも、キーの記録から取得できます。

切断されたすべての呼び出しがリカバリできるわけではありません。送信する前にリクエストとキーを保存しておき、[リトライ結果テーブル](/ja/development/comfy-router/api#retry-outcomes)を使用してください。新しいキーは新しい呼び出しを作成し、別途課金が発生する可能性があります。

## リクエストは呼び出し元ごとにレート制限される

| レスポンス                                | 原因                                    | 対応                                          |
| ------------------------------------ | ------------------------------------- | ------------------------------------------- |
| `429` / `concurrency_limit_exceeded` | 同時呼び出しが多すぎるか、コミット済み支出の上限に対する余裕が不十分です。 | 並行作業を減らしてください。支出ヘッダーは、支出上限と呼び出し回数の制限を区別します。 |
| `429` / `rate_limited`               | リクエストの割り当てを使い切りました。                   | 再試行する前に `Retry-After` を待ってください。             |

リクエストレートの制限は、呼び出しとカタログ/スキーマの読み取りに適用され、生成前に拒否されたリクエストも含まれます。これはソース IP ではなく、認証された呼び出し元に従います。呼び出し元のプロバイダーキーを使用した呼び出しは対象外ですが、プロバイダーの制限は引き続き適用されます。

カタログとスキーマの読み取りはキャッシュしてください。スキーマは `ETag` と `If-None-Match` で再検証してください。再試行とコミット済み支出のフィールドについては[ヘッダー](/ja/development/comfy-router/headers)を参照してください。

## 呼び出し実行中は進捗がありません

Routerは最終的な応答を返し、ストリーミングされるトークン、サーバー送信イベント、進捗率の更新、中間のプレビューフレームはありません。プロバイダーの内部ポーリング状態は、リクエスト中には転送されません。

不確定な進捗インジケーターを表示してください。進捗やストリーミングが必要な場合は、それを公開しているパートナープロキシのオペレーションを使用してください。

<span id="no-cost-or-credit-figures-on-a-response" />

## Comfy の課金と使用量

レスポンスにはプロバイダーの使用量やコストのフィールドが含まれる場合があります。これらは Comfy の一律の課金を表すものではありません。`X-Comfy-Credits-Used` はオプションであり、リプレイされません。残高、使用量、請求書については Comfy プラットフォームを使用してください。

カタログは価格ではなく、`billing.charges_on_policy_rejection` などの請求に関する事実を提供します。`yes`、`no`、`unknown` を明示的に処理してください。詳細は [billing](/ja/development/comfy-router/api#model-billing-facts) を参照してください。

## Routerはすべてのパートナー操作をカバーしていない

Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。[Comfy API specification](/openapi-v2.yaml) を確認してください。サポートはプロバイダーによって異なります。

## モデルの出力と保存されたアセット

入力フィールドと出力フィールドはモデルによって異なります。プロバイダー SDK やプロキシから移行すると、ルートと結果の読み取り方法の両方が変わる可能性があります。

一部のアセットは Comfy ストレージに再ホストされます。その他はプロバイダーの URL またはインラインバイトです。有効期間とリプレイ動作については、[結果アセット](/ja/development/comfy-router/reference#結果アセット) を参照してください。

## 次のステップ

<CardGroup cols={2}>
  <Card title="クイックスタート" icon="rocket" href="/ja/development/comfy-router/quickstart">
    Comfy Router を通じて最初の画像を生成します。
  </Card>

  <Card title="Router API の使用" icon="code" href="/ja/development/comfy-router/api">
    モデルを選択し、そのスキーマを確認して、結果と再試行を処理します。
  </Card>
</CardGroup>