# 사용 가능한 모델 목록 조회

**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로 설정하세요. 이미지 모델은 계속 대상입니다.

## 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 | 선택적 공급자 필터입니다(예: 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": "모델 카탈로그 생성 시각(유닉스 초)입니다."
    },
    "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
}
```
