# 利用可能なモデルの一覧を取得

**API:** Model API

**Endpoint:** `GET /api/v1/models`

既定では、chat、image_generation、video_generation、decisions を含むすべてのモデルカテゴリを返します。モデルは有効で、一覧に表示され、削除されておらず、最新の料金が設定されている必要があります（0 も有効です）。任意の provider フィルターを指定しても、既存の料金とマッピングの条件は維持されます。結果は管理者の sort_order の昇順、次にモデル名と ID の順に並びます。新しく同期されたモデルは、管理者が一覧に表示するまで非表示です。非表示は検出用の一覧にのみ影響し、無効化すると新しい呼び出しも拒否されます。モデル詳細の参照は変わりません。呼び出し先のエンドポイントを選ぶ前に model_kind を確認してください。video_generation は /api/v1/videos/generations、decisions は /api/v1/decisions を使用します。専用の検出用一覧は /api/v1/videos/models と /api/v1/decisions/models で利用できます。exclude_video_and_decisions=true を設定すると、プロバイダーのカテゴリ上書き後に動画と decision のモデルを除外できます。画像モデルは引き続き対象です。

## Base URL

- `https://openapi.felo.ai` — 本番環境

## Authentication

- `FeloBearerAuth` (http bearer) — Felo APIキーを `Authorization: Bearer <key>` として送信します。
- `FeloApiKey` (apiKey in header `X-API-Key`) — Felo APIキーを `X-API-Key: <key>` として送信します。

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `exclude_video_and_decisions` | query | no | boolean, default: false | 任意の provider フィルター（例：ephone、openrouter）。 |

## Responses

### 200 — 利用可能なモデル

**application/json**

Schema: `ModelList` (`#/components/schemas/ModelList`)

### 401 — Felo APIキーが無効または未指定です

**application/json**

Schema: `OpenAIErrorResponse` (`#/components/schemas/OpenAIErrorResponse`)

### 422 — 無効なクエリパラメーター（空の provider、無効なブール値など）

**application/json**

Schema: object

```json
{
  "type": "object",
  "required": [
    "detail"
  ],
  "properties": {
    "detail": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  }
}
```

### 503 — モデルカタログが一時的に利用できません

**application/json**

Schema: `OpenAIErrorResponse` (`#/components/schemas/OpenAIErrorResponse`)

## Schema definitions

### Model

`#/components/schemas/Model`

```json
{
  "type": "object",
  "required": [
    "id",
    "object",
    "created",
    "owned_by"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Felo モデル ID。"
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "モデルカタログの作成タイムスタンプ（Unix 秒）。"
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "有効なプロバイダーマッピングの上書き後の、実際のモデル機能カテゴリ（chat、image_generation、video_generation、decisions）。このカテゴリに対応する呼び出しエンドポイントを使用してください。"
    }
  },
  "additionalProperties": true
}
```

### ModelList

`#/components/schemas/ModelList`

```json
{
  "type": "object",
  "required": [
    "object",
    "data"
  ],
  "properties": {
    "object": {
      "type": "string",
      "const": "list"
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Model"
      }
    }
  },
  "additionalProperties": true
}
```

### OpenAIErrorResponse

`#/components/schemas/OpenAIErrorResponse`

```json
{
  "type": "object",
  "description": "OpenAI 互換のエラーエンベロープ。Router は、上流の任意フィールドをすべて含めずに code と message を返す場合があります。",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "指定された場合の OpenAI 互換のエラータイプ。"
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
