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

# モデル一覧の取得

> 現在のアカウントで利用可能なモデル識別子を一覧表示します。

`GET /api/v1/cloud/models`

現在のアカウントで有効なモデルを一覧表示します。Agent の作成または更新時に `model` の値を選択するためにこのエンドポイントを使用してください。

## ヘッダー

| ヘッダー            | 必須 | 説明                  |
| --------------- | -- | ------------------- |
| `Authorization` | はい | `Bearer $QODER_PAT` |

## クエリパラメータ

このエンドポイントは現在クエリパラメータを受け付けません。

## リクエスト例

```bash theme={null}
curl -X GET "https://api.qoder.com/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"
```

## レスポンス例

**HTTP 200 OK**

```json theme={null}
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high", "xhigh", "max"],
      "default_effort": "high",
      "max_input_tokens": 1000000,
      "default_context_window": 200000,
      "available_context_windows": [200000, 400000, 1000000]
    }
  ],
  "has_more": false
}
```

## レスポンスフィールド

| フィールド      | 型       | 説明                                                                 |
| ---------- | ------- | ------------------------------------------------------------------ |
| `data`     | array   | 利用可能な[モデルオブジェクト](/ja/cloud-agents/api/models/schemas#model-object) |
| `has_more` | boolean | 常に `false`。モデルリストはページネーションされません                                    |

各モデルオブジェクトには以下が含まれます:

| フィールド                       | 型                | 説明                                                                               |
| --------------------------- | ---------------- | -------------------------------------------------------------------------------- |
| `id`                        | string           | Agent の `model` として渡すモデル識別子                                                      |
| `type`                      | string           | 固定値 `"model"`                                                                    |
| `display_name`              | string           | 人間が読めるモデル名                                                                       |
| `source`                    | string           | モデルソース、通常は `system`。アカウント固有のモデルの場合は `user`                                       |
| `is_enabled`                | boolean          | モデルが有効で使用可能かどうか                                                                  |
| `is_new`                    | boolean          | モデルが新規としてマークされているかどうか                                                            |
| `price_factor`              | number           | 任意の相対価格倍率                                                                        |
| `efforts`                   | array            | 任意のサポートされる推論エフォートレベル。`none`、`low`、`medium`、`high`、`xhigh`、`max` など               |
| `default_effort`            | string           | 上流カタログで指定されている場合の任意のデフォルトエフォートレベル                                                |
| `max_input_tokens`          | integer          | モデルがサポートする最大入力コンテキスト(トークン数)                                                      |
| `default_context_window`    | integer          | 任意。Agent が設定しない場合に使用するデフォルトのコンテキストウィンドウ(トークン数)                                   |
| `available_context_windows` | array of integer | 任意。Agent の作成/更新時に `model.context_window` として受け付ける、ユーザー選択可能なコンテキストウィンドウの階層(トークン数) |

## 注意事項

* 有効なモデルのみが返却されます。
* レスポンスには内部ルーティング、プロバイダー、シークレット、`description` フィールドは含まれません。
* モデルカタログは認証されたユーザーとサービスの設定シーンに基づいて解決されます。デフォルトのシーンは `assistant` です。

## エラー

| HTTP | タイプ                    | トリガー条件           |
| ---- | ---------------------- | ---------------- |
| 401  | `authentication_error` | PAT が無効または期限切れ   |
| 503  | `api_error`            | モデルカタログが一時的に利用不可 |

エラーエンベロープの詳細については[エラーリファレンス](/ja/cloud-agents/api/conventions/errors)を参照してください。

## 関連項目

<CardGroup cols={2}>
  <Card title="Agent の定義" icon="user-gear" href="/ja/cloud-agents/define-agent">
    再利用可能でバージョン管理された Agent 構成を作成します。
  </Card>
</CardGroup>