# Referencia de endpoints

> Todos los endpoints públicos de la API de Jeimy.

URL base: `https://api.jeimy.ai`

| Método | Ruta | Llave | Qué hace |
|---|---|---|---|
| `POST` | `/v1/chat/completions` | Sí | Chat en formato OpenAI. Ver [Chat](https://docs.jeimy.ai/api/chat/) |
| `POST` | `/v1/messages` | Sí | Chat en formato Anthropic. Ver [Mensajes](https://docs.jeimy.ai/api/mensajes/) |
| `GET` | `/v1/models` | No | Catálogo de modelos |
| `GET` | `/v1/pricing` | No | Tarifas vigentes en soles |
| `GET` | `/v1/plans` | No | Planes del chat web |

## `GET /v1/models`

```json
{
  "models": [
    { "slug": "colibri", "displayName": "Colibrí 2", "description": "…", "vision": true, "inPlans": true, "inFree": true },
    { "slug": "aguila", "displayName": "Águila", "description": "…", "vision": true, "inPlans": true, "inFree": false },
    { "slug": "apu", "displayName": "Apu", "description": "…", "vision": true, "inPlans": false, "inFree": false }
  ]
}
```

## `GET /v1/pricing`

```json
{
  "currency": "PEN",
  "perMillionTokens": {
    "colibri": { "inputPerMillionPEN": 0.6, "cachePerMillionPEN": 0.15, "outputPerMillionPEN": 1.2 },
    "aguila": { "inputPerMillionPEN": 2.5, "cachePerMillionPEN": 1.1, "outputPerMillionPEN": 16 },
    "apu": { "inputPerMillionPEN": 16, "cachePerMillionPEN": 1.6, "outputPerMillionPEN": 50 }
  },
  "minTopUpPEN": 20
}
```

## `GET /v1/plans`

```json
{
  "plans": [
    { "id": "basico", "displayName": "Básico", "pricePEN": 30, "usageLabel": "Uso estándar", "webSearch": true }
  ]
}
```
