Gateway IA souveraine 3GK
API compatible OpenAI pour exécuter des inférences LLM sur infrastructure hébergée en France. Routage prioritaire vers nos instances vLLM locales avec fallback Scaleway (Paris) en cas d'indisponibilité — aucune donnée ne quitte le territoire français.
Présentation#pitch
La gateway expose une API REST minimale qui réplique le contrat openai.chat.completions. Les SDK officiels OpenAI (Python, Node.js) fonctionnent sans modification — il suffit de pointer base_url vers notre domaine et d'utiliser une clé sk-3gk-….
Base URL#base-url
Toutes les routes publiques sont préfixées par /v1.
Prérequis#prerequis
- Un compte client actif sur la plateforme.
- Une clé API générée depuis votre dashboard — format
sk-3gk-suivi de 48 caractères alphanumériques. - Un client HTTP capable de gérer les Server-Sent Events si vous utilisez le streaming.
Modèles disponibles#modeles
La plateforme expose des alias stables — 3gk-llm (chat), 3gk-embed (embeddings) et 3gk-rerank (reranking) — découplés des modèles sous-jacents : une montée de version ne change jamais votre intégration. La liste à jour est accessible via GET /v1/models.
Aller plus loin#aller-plus-loin
- Authentification — format des clés, exemples curl, gestion des erreurs 401.
- Chat completions — endpoint principal, paramètres, exemples multi-langages.
- Routage & souveraineté — comment la gateway choisit entre vLLM local et Scaleway, garanties RGPD.
