URL de base
Le réglage qui fait trébucher tout le monde : l’URL attendue par chaque client, avec ou sans le suffixe /v1.
Presque tous les échecs d’intégration sont dus à une erreur d’URL de base. Cette page indique précisément quelle valeur définir.
La règle
| Client | Définir l’URL de base sur | Il appelle ensuite |
|---|---|---|
| SDK Anthropic (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| SDK OpenAI (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Clients Anthropic : sans
/v1. Clients OpenAI : avec /v1. Le SDK Anthropic ajoute /v1/messages à toute URL de base que vous lui fournissez ; le SDK OpenAI ajoute uniquement /chat/completions. Ajouter /v1 à une URL de base Anthropic produit des requêtes vers /v1/v1/messages, ce qui renvoie une erreur 404.Comment identifier votre erreur
| Vous voyez | Signification |
|---|---|
404 et le chemin contient /v1/v1/ | Vous avez ajouté /v1 à une URL de base de type Anthropic. Supprimez-le. |
404 sur /chat/completions sans /v1 | Vous avez omis /v1 dans une URL de base de type OpenAI. Ajoutez-le. |
404 sur /v1/chat/completions depuis un outil Anthropic | L’outil utilise Messages, et non Chat Completions. Utilisez l’URL de base et le point de terminaison Anthropic. |
| La connexion fonctionne, mais chaque appel renvoie une erreur 401 | L’URL est correcte, mais l’en-tête d’authentification ne correspond pas à ce format. Consultez Authentification. |
Vérification sans SDK
C’est le moyen le plus rapide de vérifier que l’URL et la clé sont correctes avant de mettre en cause votre framework :
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 signifie que l’URL et la clé sont toutes deux correctes, et que tout problème restant vient de la configuration de votre client.