# Obter um modelo

**API:** Model API

**Endpoint:** `GET /api/v1/models/{model_id}`

Retorna um modelo configurado pelo seu ID de modelo da Felo.

## Base URL

- `https://openapi.felo.ai` — Produção

## Authentication

- `FeloBearerAuth` (http bearer) — Chave de API da Felo enviada como `Authorization: Bearer <key>`.
- `FeloApiKey` (apiKey in header `X-API-Key`) — Chave de API da Felo enviada como `X-API-Key: <key>`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `model_id` | path | yes | string | ID de modelo da Felo retornado pelo endpoint de listagem de modelos. |

## Responses

### 200 — Metadados do modelo

**application/json**

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

### 401 — Chave de API da Felo inválida ou ausente

**application/json**

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

### 404 — Modelo não encontrado

**application/json**

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

### 503 — O catálogo de modelos está temporariamente indisponível

**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 modelo da Felo."
    },
    "object": {
      "type": "string",
      "const": "model"
    },
    "created": {
      "type": "integer",
      "format": "int64",
      "description": "Timestamp de criação no catálogo de modelos, em segundos Unix."
    },
    "owned_by": {
      "type": "string"
    },
    "model_kind": {
      "type": "string",
      "description": "Categoria efetiva de capacidade do modelo após as substituições de mapeamento de provedor ativo: chat, image_generation, video_generation ou decisions. Use o endpoint de chamada correspondente a esta categoria."
    }
  },
  "additionalProperties": true
}
```

### OpenAIErrorResponse

`#/components/schemas/OpenAIErrorResponse`

```json
{
  "type": "object",
  "description": "Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "message"
      ],
      "properties": {
        "message": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "Tipo de erro compatível com a OpenAI, quando fornecido."
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```
