# Lister les modèles vidéo disponibles

**API:** Model API

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

Renvoie uniquement les modèles dont la valeur effective de model_kind est video_generation. Un mappage de fournisseur activé peut remplacer la catégorie de base du modèle ; sans filtre de fournisseur, la priorité de mappage décroissante puis le nom de fournisseur croissant déterminent la substitution. Si aucun mappage activé ne fournit de catégorie, la catégorie de base est utilisée (chat par défaut). Utilise la même visibilité, la même tarification à jour, le même filtre de fournisseur et le même ordre stable que GET /api/v1/models. Un résultat vide renvoie HTTP 200 avec object=list et data=[]. Il s'agit d'une lecture du catalogue local : elle ne synchronise pas les modèles amont et ne facture pas d'appel de modèle. Les détails restent disponibles via GET /api/v1/models/{model_id}. Le point de terminaison général GET /api/v1/models continue d'inclure toutes les catégories.

## Base URL

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

## Authentication

- `FeloBearerAuth` (http bearer) — Clé API Felo envoyée dans l'en-tête `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — Clé API Felo envoyée dans l'en-tête `X-API-Key: <key>`.

## Responses

### 200 — Modèles disponibles

**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 — Clé API Felo invalide ou manquante

**application/json**

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

### 422 — Paramètre de requête invalide, par exemple un provider vide

**application/json**

Schema: object

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

### 503 — Le catalogue de modèles est temporairement indisponible

**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 de modèle Felo."
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "Horodatage de création dans le catalogue de modèles, en secondes Unix."
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "Catégorie de capacité effective du modèle après les substitutions des mappages de fournisseur activés : chat, image_generation, video_generation ou decisions. Utilisez le point de terminaison d'appel correspondant à cette catégorie."
    }
  },
  "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": "Enveloppe d'erreur compatible OpenAI. Le Router peut inclure code et message sans tous les champs amont facultatifs.",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "Type d'erreur compatible OpenAI lorsqu'il est fourni."
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
