# Список доступных видеомоделей

**API:** Model API

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

Возвращает только модели, у которых эффективный model_kind — video_generation. Включённое сопоставление провайдера может переопределить базовую категорию модели; без фильтра по провайдеру переопределение определяется по убыванию приоритета сопоставления и возрастанию имени провайдера. Если ни одно включённое сопоставление не задаёт категорию, используется базовая категория (chat, если она отсутствует). Использует те же правила видимости, актуальных цен, фильтра по провайдеру и стабильной сортировки, что и GET /api/v1/models. Пустой результат возвращает HTTP 200 с object=list и data=[]. Это чтение локального каталога: оно не синхронизирует upstream-модели и не тарифицирует вызов модели. Сведения по-прежнему доступны через GET /api/v1/models/{model_id}. Общий эндпоинт GET /api/v1/models по-прежнему включает все категории.

## Base URL

- `https://openapi.felo.ai` — Боевая среда

## Authentication

- `FeloBearerAuth` (http bearer) — API-ключ Felo, передаваемый как `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — API-ключ Felo, передаваемый как `X-API-Key: <key>`.

## Responses

### 200 — Доступные модели

**application/json**

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

Example:

```json
{
  "object": "list",
  "data": [
    {
      "id": "seedance-2.0-mini",
      "object": "model",
      "created": 1788220800,
      "owned_by": "Felo Router",
      "model_kind": "video_generation"
    }
  ]
}
```

### 401 — Недействительный или отсутствующий API-ключ Felo

**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": "ID модели Felo."
    },
    "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 без всех необязательных полей upstream.",
  "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
}
```
