Mensajes (formato Anthropic)

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.

Por dentro es el mismo servicio que /v1/chat/completions: mismos modelos, mismos precios y mismos límites.

Petición

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 8192, 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.

Respuesta

{
  "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:

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