Un endpoint est un chemin URL sur un serveur qui accepte un type spécifique de requête et renvoie un type spécifique de réponse. Dans les API d'IA, l'endpoint le plus courant est celui de complétion de chat — POST /v1/chat/completions dans le schéma d'OpenAI, POST /v1/messages chez Anthropic. Mais les fournisseurs d'IA modernes exposent une constellation d'endpoints au-delà du chat : /v1/embeddings pour transformer du texte en vecteurs, /v1/images/generations pour la création d'images, /v1/audio/transcriptions pour la conversion parole-texte, et /v1/models pour lister les modèles disponibles. Chaque endpoint attend des paramètres de requête différents et renvoie des formats de réponse différents.
Le défi pratique est que les endpoints « compatibles OpenAI » ne le sont qu'approximativement. Groq, Together AI et Fireworks annoncent tous la compatibilité OpenAI, et ils fonctionnent bien pour les requêtes de complétion de chat basiques. Mais en creusant les détails, vous trouverez des différences : certains ne prennent pas en charge le paramètre response_format pour la sortie structurée, d'autres gèrent différemment l'appel d'outils/fonctions, et les formats de réponse d'erreur varient considérablement. Anthropic ne tente même pas d'être compatible OpenAI — leur API Messages utilise une structure entièrement différente, avec content sous forme de tableau de blocs plutôt qu'une simple chaîne de caractères. Quand vous construisez un système qui route entre plusieurs fournisseurs, ces différences sont là où la majorité du temps d'ingénierie est investi.
Le versionnage est une autre dimension importante. Les fournisseurs font évoluer leurs endpoints au fil du temps, et des changements incompatibles surviennent. OpenAI utilise un versionnage basé sur les dates (comme gpt-4-0125-preview), tandis que les chemins d'endpoints restent stables. Anthropic inclut un en-tête de version (anthropic-version: 2023-06-01) qui détermine le schéma requête/réponse. Vertex AI de Google utilise des préfixes de version dans le chemin URL. Quand un fournisseur déprécie une version d'endpoint, vous avez généralement quelques mois de préavis, mais si vous ne surveillez pas leurs changelogs, vous pourriez vous réveiller un matin avec une intégration cassée.
Les URL de base méritent aussi d'être mentionnées, car elles ne sont pas aussi simples qu'on pourrait s'y attendre. L'API d'Anthropic se trouve à api.anthropic.com, mais OpenAI offre api.openai.com pour l'accès direct et des URL de base distinctes pour les déploiements Azure OpenAI Service. Certains fournisseurs ont des endpoints régionaux pour la conformité à la résidence des données — vos requêtes vers europe-west1-aiplatform.googleapis.com restent dans l'UE. Pour les fournisseurs qui passent par des plateformes d'inférence comme l'Inference API de HuggingFace, l'URL de base est la plateforme (router.huggingface.co) et l'identifiant du modèle va dans le chemin ou les en-têtes. Comprendre cette topologie est important, car la latence, la souveraineté des données et la facturation peuvent toutes dépendre de l'endpoint que vous atteignez réellement.