Documentation pour l’IA

Transmettez les liens ci-dessous à un assistant d’IA pour l’aider à connecter votre application personnelle à la passerelle d’IA. L’assistant doit aussi disposer d’un outil capable d’envoyer des requêtes HTTP ou d’exécuter du code, pouvoir accéder à votre instance par le réseau et obtenir votre autorisation explicite pour utiliser son token. Lire cette documentation ne donne aucun accès, n’installe aucun skill et ne suffit pas à rendre un modèle capable d’appeler des outils.

Ressource	Utilité
Guide de la passerelle d’IA	Installation, champs exacts des requêtes, diffusion, quotas et récupération
Guide Markdown de la passerelle d’IA	Le même guide et des exemples exécutables, sans interface de page ni scripts
OpenAPI 3.1	Points d’accès pour les requêtes aux modèles, authentification Bearer, requêtes, réponses et erreurs
Sessions à distance	Lancement de sessions liées à un projet, SSE en direct, terminal, saisie, autorisations et récupération des intentions
OpenAPI des sessions	Protocole exact des sessions et authentification
Skill d’intégration	Fichier portable `SKILL.md` expliquant la découverte des modèles et les appels sûrs
Index de la documentation	Liens vers les guides publics et leurs versions Markdown
Documentation publique complète	Guides publics réunis dans un seul document texte

Chaque guide public possède une adresse Markdown : ajoutez .md à son URL canonique. Le document complet contient les guides destinés aux utilisateurs, mais aucune donnée d’instance privée ni aucun fichier réservé aux opérateurs. Le guide de l’API et ses exemples sont générés à partir des mêmes sources que la page lisible par une personne et l’application.

Donner le bon contexte à un assistant

Copiez cette instruction dans un assistant qui possède les outils nécessaires :

Read https://aircodezero.com/skills/aircode-ai-gateway/SKILL.md
and https://aircodezero.com/docs/ai-gateway.md.
Integrate my personal application with my own AI gateway.
Read AIRCODE_AI_BASE_URL and AIRCODE_AI_TOKEN from its secret environment.
Do not display those values or send them to the documentation website.
List the available models and use the exact model I select.
Use text-only Chat Completions and disable automatic generation retries.
Explain the current buffered-streaming behavior accurately.

Si l’assistant accepte des dossiers de skills, enregistrez le fichier lié sous aircode-ai-gateway/SKILL.md dans le dossier qu’il utilise. Ce site ne lance aucune installation automatique. Les autres assistants peuvent lire ce fichier comme instruction sans rien installer.

Choix nécessaires pour l’intégration

L’URL de base et le token doivent provenir de la même instance. Consultez /models avant de choisir un modèle : n’inventez jamais un ID de moteur et ne promettez pas l’accès à tous les modèles d’un abonnement. L’utilisateur choisit le modèle et tout niveau d’effort non standard.

Gardez les identifiants dans le backend qui effectue les appels. Ce site ne propose ni bac à sable API, ni formulaire pour saisir un token, ni proxy vers l’instance du propriétaire. Ne placez jamais d’identifiants dans l’URL du serveur OpenAPI, dans une chaîne de requête ou dans un fichier de skill partagé. Configurez les outils OpenAPI avec l’URL de l’instance et le secret Bearer dans leurs paramètres privés.

L’API actuelle prend en charge les Chat Completions en texte seul et les flux SSE mis en tampon. Elle n’expose ni les outils de projet, ni les sessions de code interactives, ni les protocoles Anthropic Messages ou Responses. Ne configurez pas un agent de code exigeant ces protocoles comme si cette passerelle textuelle était un fournisseur complet.