# Daftar model video yang tersedia

**API:** Model API

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

Hanya mengembalikan model yang model_kind efektifnya video_generation. Pemetaan penyedia yang diaktifkan dapat menimpa kategori dasar model; tanpa filter penyedia, prioritas pemetaan menurun dan nama penyedia menaik menentukan penimpaan. Jika tidak ada pemetaan yang diaktifkan yang menyediakan kategori, kategori dasar digunakan (chat jika tidak ada). Menggunakan visibilitas, harga saat ini, filter penyedia, dan pengurutan stabil yang sama seperti GET /api/v1/models. Hasil kosong mengembalikan HTTP 200 dengan object=list dan data=[]. Ini adalah pembacaan katalog lokal: tidak menyinkronkan model upstream atau mengenakan biaya untuk panggilan model. Detail tetap tersedia melalui GET /api/v1/models/{model_id}. Endpoint umum GET /api/v1/models tetap mencakup semua kategori.

## 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>`.

## Responses

### 200 — Model yang tersedia

**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 — Kunci API Felo tidak valid atau tidak ada

**application/json**

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

### 422 — Parameter kueri tidak valid, misalnya provider kosong

**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
}
```
