Abstract
Un formato nuevo para describir APIs pensado para LLMs. Gasta un 85.5% menos de tokens que OpenAPI YAML y un 88.6% menos que OpenAPI JSON, probado con APIs de GitHub, Twilio y DigitalOcean.
OpenAPI se diseñó para generar código y documentar. Cuando un LLM lo lee, se gasta tokens en información que al modelo no le sirve.
LAPIS es un formato para describir APIs pensado para cómo leen la documentación los modelos de lenguaje. Lo probé con APIs de GitHub, Twilio y DigitalOcean, y la reducción media es del 85.5% de tokens frente a OpenAPI YAML y del 88.6% frente a JSON.
Además de ocupar menos, LAPIS incluye manejo centralizado de errores, triggers de webhooks, descripción de rate limiting y flujos de operaciones, cosas que OpenAPI reparte por todas partes o no contempla.
Hay un conversor automático desde OpenAPI 3.x, y la especificación es abierta, con licencia CC BY 4.0.