> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-willie-des-1087-router-migration-block.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)から始めてください。                                       |
| ジョブを送信して後で受け取る   | キュー配信: `POST /v2/models/{provider}/{model}/requests` が `request_id` を返し、ポーリングして受け取ることができます。完了 webhook はありません。 | [キュー配信](/ja/development/comfy-router/queue)を使用してください。送信とポーリングの操作を備えたパートナープロキシでは、プロバイダー自身の制御を利用できます。 |
| 進捗の表示や出力のストリーミング | 呼び出し中にライブ進捗、ストリーミング、プレビューフレームはありません。                                                                          | 不確定な状態を表示するか、サポートされているプロキシ操作を使用してください。                                                              |
| 接続が失われた後の復旧      | Router が受け付けた生成のハンドルを保持していた場合、同じキーでの収集が可能です。                                                                  | キーを保持し、[再試行ガイダンス](/ja/development/comfy-router/api#retry-outcomes)に従ってください。                         |
| Comfy の課金を照合する   | レスポンスに汎用的な Comfy のコストやクレジット残高のフィールドはありません。                                                                    | [ワークスペースの請求](https://platform.comfy.org)を使用してください。                                                  |
| 結果を永続的に保存する      | 再ホストされた URL やリプレイされた URL を含め、アセット URL は期限切れになる可能性があります。                                                       | アセットをダウンロードしてください。詳細は[結果アセット](/ja/development/comfy-router/reference#結果アセット)を参照してください。              |

<span id="no-queued-submission" />

## キューによる送信

同期ルートは、モデルの実行中も接続を開いたまま保持します。非同期プロバイダーの場合、Router はジョブを送信し、内部的にポーリングします。代替となるのはキューによる配信（送信し、`request_id` を取得し、ポーリングし、収集する）です。詳しくは[キューによる配信](/ja/development/comfy-router/queue)を参照してください。これは認証情報の背後にあるワークスペースにスコープされるため、Comfy ワークスペースで作成したキーが必要です。ワークスペースを持たないレガシーキー、bring-your-own-key リクエスト、またはキューで実行できないモデルは、送信ルートで `not_enabled` とともに `403` を返します。どちらのモードもコールバックや Webhook は提供しません。

リクエストを十分な時間開いたままにできない場合は、キューに投入してください。プロバイダー自身の送信とポーリングの制御が必要な場合は、[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)を使用してください。

現在、2 つのモデルは同期専用であり、キューに送信すると `403` / `not_enabled` で拒否されます。`elevenlabs/eleven_sfx_v2` と `elevenlabs/eleven_v3` です。これらは JSON の結果ドキュメントではなく生のオーディオバイト列を返すため、キューによる配信にはそれを保存する場所がありません。同期ルートで実行してください。同期ルートはこれらのバイト列を通常どおり返します。

LTX v1 のテキストから動画へ、および画像から動画への操作も同じ理由で生のビデオバイト列を返すため、キューによる配信ではそれらを保存できません。ただし、これらに到達できるのは `/proxy/ltx/v1/…` の[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)経由のみであり、Router のモデル id からは到達できません。すべての `ltx/*` カタログモデルは、キューに投入可能な v2 の送信とポーリングの操作に解決されるためです。

## サーバーのデッドラインで呼び出しが打ち切られます

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

`504` / `deadline_exceeded` は Router が待機を停止したことを意味し、`504` / `provider_timeout` はプロバイダーがタイムアウトしたことを意味します。タイムアウトや接続の喪失は、生成が課金されなかったことを証明するものではなく、受け入れ済みのプロバイダー側の処理をキャンセルするものでもありません。再試行する前に[タイムアウトと課金](/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>