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

# Comfy Router モデルを検出する

> GET /v2/models で Comfy Router のカタログを一覧表示し、カーソルでページを送り、モデルのエントリを ID で 1 件取得します。

すべての Router モデルは `{provider}/{model}` 形式の ID で指定します。カタログを使ってその ID を見つけ、`POST /v2/models/{provider}/{model}` を呼び出します。

## カタログを検出する

生成に使用したのと同じ APIキーでモデルを一覧表示します:

```bash theme={null}
curl -H "X-API-Key: $COMFY_API_KEY" \
  "https://api.comfy.org/v2/models?limit=50"
```

カタログレスポンスの抜粋:

```json theme={null}
{
  "data": [
    {
      "id": "bfl/flux-2-pro",
      "provider": "bfl",
      "model": "flux-2-pro",
      "billing": { "charges_on_policy_rejection": "no" }
    }
  ],
  "has_more": true,
  "next_cursor": "example-cursor",
  "limit": 50
}
```

呼び出しパスには `id` を使用します。`billing` オブジェクトには課金に関する事実が含まれており、価格ではありません。これに依存する前に [ポリシー拒否時の課金](/ja/development/comfy-router/billing#モデル課金に関する事実) をお読みください。

### ページネーション

* `has_more` が `true` の場合は、返された `next_cursor` を `cursor` として渡します。前のページが要求より短かった場合でも、`has_more` が `false` になったら停止します。
* カーソルは不透明な値として扱います。たとえば cURL の `--get --data-urlencode "cursor=$NEXT_CURSOR"` のように値を URL エンコードしてください。オフセットを計算したりカーソルを変更したりしないでください。
* `limit` のデフォルトは 20 で、上限は 100 です。上限を超える値は上限値に丸められます。ゼロおよびネガティブな値はデフォルトを選択します。レスポンスには実際に使用された limit が報告されます。
* 無効なカーソルは `400` / `invalid_input` を返します。リストを暗黙的に再起動することはありません。
* カーソルはカタログの更新をまたいでも有効なままの場合がありますが、走査はスナップショットではありません。現在位置より前に追加されたモデルが、その走査に現れないことがあります。

`503` / `service_unavailable` は一時的なものです。バックオフしながら再試行してください。空のカタログとして扱わないでください。SDK の run メソッドは選択済みのモデルを直接呼び出します。

## 1 つのモデルを読み取る

モデル ID がわかっている場合は、カタログのエントリを直接取得します:

```bash theme={null}
curl -H "X-API-Key: $COMFY_API_KEY" \
  https://api.comfy.org/v2/models/bfl/flux-2-pro
```

モデル詳細エンドポイントを使えば、カタログ全体を走査せずに済みます。エントリの完全なフィールドについては [API リファレンス](/ja/development/comfy-router/reference) を参照してください。

## 次のステップ

* [スキーマと結果](/ja/development/comfy-router/schemas): モデルを呼び出す前に、そのモデルの入力と出力のスキーマを確認します。
* [すべてのモデル](/ja/development/comfy-router/models): 各モデルで実際に動作するリクエストとともにカタログをブラウズします。