# Daftar model yang tersedia

**API:** Model API

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

Secara default, mengembalikan semua kategori model, termasuk chat, image_generation, video_generation, dan decisions. Model harus diaktifkan, terdaftar, belum dihapus, dan memiliki harga saat ini (nilai nol adalah valid). Filter penyedia opsional mempertahankan kondisi harga dan pemetaan yang ada. Hasil diurutkan berdasarkan sort_order administrator secara menaik, lalu nama dan ID model. Model yang baru disinkronkan disembunyikan hingga didaftarkan oleh administrator. Penyembunyian hanya memengaruhi daftar penemuan; penonaktifan juga menolak panggilan baru. Pencarian detail model tidak berubah. Baca model_kind sebelum memilih endpoint pemanggilan: video_generation menggunakan /api/v1/videos/generations; decisions menggunakan /api/v1/decisions. Daftar penemuan khusus tersedia di /api/v1/videos/models dan /api/v1/decisions/models. Setel exclude_video_and_decisions=true untuk mengecualikan model video dan decisions setelah penimpaan kategori penyedia; model gambar tetap memenuhi syarat.

## Base URL

- `https://openapi.felo.ai` — Produksi

## Authentication

- `FeloBearerAuth` (http bearer) — Kunci API Felo dikirim sebagai `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — Kunci API Felo dikirim sebagai `X-API-Key: <key>`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `exclude_video_and_decisions` | query | no | boolean, default: false | Filter penyedia opsional, misalnya ephone atau openrouter. |

## Responses

### 200 — Model yang tersedia

**application/json**

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

### 401 — Kunci API Felo tidak valid atau tidak ada

**application/json**

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

### 422 — Parameter kueri tidak valid, misalnya provider kosong atau nilai boolean yang tidak valid

**application/json**

Schema: object

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

### 503 — Katalog model sementara tidak tersedia

**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 model Felo."
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "Stempel waktu pembuatan katalog model dalam detik Unix."
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "Kategori kemampuan model efektif setelah penimpaan pemetaan penyedia yang diaktifkan: chat, image_generation, video_generation, atau decisions. Gunakan endpoint pemanggilan yang sesuai dengan kategori ini."
    }
  },
  "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": "Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "Tipe error yang kompatibel dengan OpenAI jika disediakan."
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
