# Mensajes (formato Anthropic)

> POST /v1/messages, compatible con la Messages API de Anthropic.

```http
POST https://api.jeimy.ai/v1/messages
```

Tiene la misma forma que la Messages API de Anthropic. Sirve para usar Jeimy desde herramientas hechas para ese formato, como la app de Claude o Claude Code. Ver [App de Claude y editores](https://docs.jeimy.ai/integraciones/claude-y-editores/).

Por dentro es el mismo servicio que [`/v1/chat/completions`](https://docs.jeimy.ai/api/chat/): mismos modelos, mismos precios y mismos límites.

## Petición

```bash
curl https://api.jeimy.ai/v1/messages \
  -H "x-api-key: $JEIMY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "aguila",
    "max_tokens": 1024,
    "system": "Responde en una frase.",
    "messages": [{"role": "user", "content": "¿Qué es Machu Picchu?"}]
  }'
```

La llave va en `x-api-key` o en `Authorization: Bearer`. En `model` va el slug de Jeimy (`colibri`, `aguila` o `apu`): un nombre de otro modelo devuelve un error con la lista de los válidos.

## Qué se admite

| Campo | Notas |
|---|---|
| `model`, `messages` | Obligatorios |
| `system` | Texto o bloques de texto |
| `max_tokens` | Por defecto 32000, que es también el tope |
| `temperature`, `top_p` | |
| `stop_sequences` | |
| `stream` | Eventos con la misma secuencia de la API de Anthropic |
| `tools`, `tool_choice` | `auto`, `any` y `tool` |

Bloques de contenido admitidos: `text`, `image` (en base64), `tool_use` y `tool_result`.

**Nota**

Las imágenes se mandan con `source.type: "base64"`. Las imágenes por URL no se admiten en este endpoint.

## Respuesta

```json
{
  "id": "...",
  "type": "message",
  "role": "assistant",
  "model": "aguila",
  "content": [{ "type": "text", "text": "Es una ciudadela inca en Cusco, Perú." }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 24, "output_tokens": 18 }
}
```

`stop_reason` puede ser `end_turn`, `max_tokens` o `tool_use`.

## Errores

Los errores vienen en la forma de Anthropic:

```json
{ "type": "error", "error": { "type": "authentication_error", "message": "API key inválida o revocada" } }
```
