# Liệt kê các mô hình khả dụng

**API:** Model API

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

Theo mặc định, trả về tất cả danh mục mô hình, bao gồm chat, image_generation, video_generation và decisions. Mô hình phải được bật, được liệt kê, chưa bị xóa và có giá hiện hành (giá bằng 0 vẫn hợp lệ). Bộ lọc provider tùy chọn giữ nguyên các điều kiện về giá và ánh xạ hiện có. Kết quả được sắp xếp theo sort_order của quản trị viên tăng dần, sau đó theo tên và ID mô hình. Các mô hình mới đồng bộ bị ẩn cho tới khi quản trị viên liệt kê. Việc ẩn chỉ ảnh hưởng đến danh sách khám phá; việc vô hiệu hóa còn từ chối các lời gọi mới. Tra cứu chi tiết mô hình không thay đổi. Đọc model_kind trước khi chọn endpoint gọi: video_generation dùng /api/v1/videos/generations; decisions dùng /api/v1/decisions. Các danh sách khám phá chuyên biệt có tại /api/v1/videos/models và /api/v1/decisions/models. Đặt exclude_video_and_decisions=true để loại trừ mô hình video và decisions sau khi nhà cung cấp ghi đè danh mục; mô hình hình ảnh vẫn đủ điều kiện.

## Base URL

- `https://openapi.felo.ai` — Môi trường production

## Authentication

- `FeloBearerAuth` (http bearer) — Khóa API Felo được gửi dưới dạng `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — Khóa API Felo được gửi dưới dạng `X-API-Key: <key>`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `exclude_video_and_decisions` | query | no | boolean, default: false | Bộ lọc provider tùy chọn, ví dụ ephone hoặc openrouter. |

## Responses

### 200 — Các mô hình khả dụng

**application/json**

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

### 401 — Khóa API Felo không hợp lệ hoặc bị thiếu

**application/json**

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

### 422 — Tham số truy vấn không hợp lệ, ví dụ provider rỗng hoặc giá trị boolean không hợp lệ

**application/json**

Schema: object

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

### 503 — Danh mục mô hình tạm thời không khả dụng

**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 mô hình Felo."
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "Dấu thời gian tạo trong danh mục mô hình, tính bằng giây Unix."
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "Danh mục khả năng hiệu dụng của mô hình sau khi ánh xạ nhà cung cấp đang bật ghi đè: chat, image_generation, video_generation hoặc decisions. Dùng endpoint gọi tương ứng với danh mục này."
    }
  },
  "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": "Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "Loại lỗi tương thích OpenAI khi được cung cấp."
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
