LAPIS: Lightweight API Specification for Intelligent Systems

Abstract

Nuevo formato de especificación de APIs diseñado para LLMs. Reduce el overhead de tokens un 85.5% frente a OpenAPI YAML y un 88.6% frente a OpenAPI JSON, con resultados probados en GitHub, Twilio y DigitalOcean.

OpenAPI fue diseñado para generadores de código y herramientas de documentación. Cuando un LLM lo procesa, consume tokens que no aportan información útil al modelo.

LAPIS es un formato de especificación de APIs pensado específicamente para cómo los modelos de lenguaje consumen documentación. Probado con APIs de GitHub, Twilio y DigitalOcean, la reducción media es del 85.5% de tokens frente a OpenAPI YAML y del 88.6% frente a JSON.

Además de la compacidad, LAPIS incluye manejo centralizado de errores, triggers de webhooks, descripción de rate limiting y flujos de operaciones, cosas que OpenAPI dispersa o no contempla directamente.

Se convierte desde OpenAPI 3.x con un conversor automático. La especificación es abierta bajo licencia CC BY 4.0.