# Elencare i modelli disponibili

**API:** Model API

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

Per impostazione predefinita, restituisce tutte le categorie di modelli, incluse chat, image_generation, video_generation e decisions. I modelli devono essere abilitati, elencati, non eliminati e avere una tariffa corrente (zero è valido). Il filtro provider facoltativo mantiene le condizioni esistenti di tariffazione e mappatura. I risultati sono ordinati per sort_order dell'amministratore in ordine crescente, poi per nome e ID del modello. I modelli appena sincronizzati restano nascosti finché un amministratore non li elenca. Nascondere un modello influisce solo sugli elenchi di scoperta; disabilitarlo rifiuta anche le nuove chiamate. La ricerca dei dettagli del modello resta invariata. Leggere model_kind prima di scegliere l'endpoint da chiamare: video_generation usa /api/v1/videos/generations; decisions usa /api/v1/decisions. Elenchi di scoperta dedicati sono disponibili su /api/v1/videos/models e /api/v1/decisions/models. Impostare exclude_video_and_decisions=true per escludere i modelli video e decisionali dopo le sostituzioni della categoria del provider; i modelli immagine restano ammissibili.

## Base URL

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

## Authentication

- `FeloBearerAuth` (http bearer) — Chiave API Felo inviata come `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — Chiave API Felo inviata come `X-API-Key: <key>`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `exclude_video_and_decisions` | query | no | boolean, default: false | Filtro provider facoltativo, ad esempio ephone o openrouter. |

## Responses

### 200 — Modelli disponibili

**application/json**

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

### 401 — Chiave API Felo non valida o mancante

**application/json**

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

### 422 — Parametro di query non valido, ad esempio un provider vuoto o un valore booleano non valido

**application/json**

Schema: object

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

### 503 — Il catalogo dei modelli è temporaneamente non disponibile

**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 modello Felo."
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "Data e ora di creazione nel catalogo dei modelli, in secondi Unix."
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "Categoria effettiva di capacità del modello dopo le sostituzioni delle mappature provider abilitate: chat, image_generation, video_generation o decisions. Usare l'endpoint di chiamata corrispondente a questa categoria."
    }
  },
  "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": "Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "Tipo di errore compatibile con OpenAI, se fornito."
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
