Référence API
Les endpoints principaux derrière la passerelle. Une seule URL de base compatible OpenAI, tous les fournisseurs connectés derrière.
Aperçu illustratif
Cette page montre la forme des endpoints principaux, pas une référence générée complète. Les paramètres, schémas et erreurs complets arrivent avec l'API.
Endpoints principaux
| POST | /chat/completions | Complétions de chat compatibles OpenAI, à travers chaque fournisseur connecté. |
| POST | /embeddings | Embeddings, même clé, même registre. |
| GET | /models | Les modèles que vos connexions débloquent en ce moment. |
| GET | /keys | Liste les clés API scopées de votre workspace. |
| POST | /keys/{id}/revoke | Révoque une clé sans toucher au compte derrière. |
| GET | /usage | Requêtes, tokens et coût en dollars — par clé, par connexion, par modèle, par jour. |
Les erreurs sont typées
Chaque erreur porte un code lisible par machine, un message localisé, un indice et un lien vers la documentation — jamais une simple pile d'appels brute.
{
"error": {
"code": "budget_exceeded",
"message": "Cette clé a atteint son budget assigné.",
"hint": "Augmentez le budget de la clé dans la console ou attendez la prochaine période de réinitialisation.",
"docs_url": "https://docs.switchgate.ai/errors/budget_exceeded"
}
}