Spécifications OpenAPI 📜

LLM Bastion fournit plusieurs spécifications OpenAPI pour faciliter l'intégration selon vos besoins, en séparant clairement les fonctionnalités de consommation (Consumer) et les outils d'administration (Management).

Spécifications disponibles

Type	Fichier	Description	Use Case
Consumer API	native.yaml	L'API native de LLM Bastion (/v1/executions)	Intégration directe pour vos applications
Management API	admin.yaml	API d'administration (Virtual Keys, Projects, Billing)	Automatisation DevOps et gestion de compte
Adapteurs	adapters.yaml	Compatibilité OpenAI et Anthropic	Pour une utilisation sans modification de code
OpenAI Only	openapi.openai.yaml	Spécification stricte format OpenAI	Intégration IDE (Cursor, VS Code)

---

Consumer vs Management

Nous avons découpé l'API native en deux pour améliorer la sécurité et la clarté de l'intégration :

1. Consumer API (native.yaml)

Cible les développeurs qui intègrent l'intelligence LLM dans leurs produits. Elle est optimisée pour la performance et le passage à l'échelle.

• Points clés : /v1/executions, /v1/traces, /v1/replay, /v1/models.

2. Management API (admin.yaml)

Cible les administrateurs et les outils de CI/CD. Elle permet de gérer les pipelines de conformité, les budgets et les accès.

• Points clés : /v1/projects, /v1/keys, /v1/audit, /rpc/pricing/sync.

---

Comment utiliser ces spécifications

Visualisation Interactive

Vous pouvez charger ces fichiers YAML dans n'importe quel visualiseur OpenAPI (comme Swagger Editor) pour générer de la documentation interactive ou des clients API.

Validation et Mocking

Ces spécifications sont idéales pour configurer des serveurs de mock ou pour valider la conformité de vos requêtes avant l'envoi vers la passerelle de production.

---

IMPORTANT

Bien que nous fournissions des adaptateurs pour la compatibilité, nous recommandons l'utilisation de la Consumer API native pour bénéficier de toutes les fonctionnalités avancées de routage par experts et de transformation de données.