L'API Anthropic est l'interface de modèles fournie par Anthropic pour appeler la série de modèles Claude. Beaucoup confondent « API Anthropic », « API Claude » et « Claude Code », alors qu'il s'agit de niveaux différents.
Cet article explique ce qu'est l'API Anthropic, comment l'appeler, en quoi elle diffère du protocole OpenAI et quelles sont les deux méthodes d'accès depuis la Chine.
Remarque : Anthropic et Claude sont des marques de leurs détenteurs respectifs. Cet article décrit les versions courantes d'octobre 2026 ; les interfaces et prix applicables sont ceux de la documentation officielle et du site.
1. Relation entre les trois concepts
- Anthropic : l'entreprise qui développe les modèles Claude.
- API Anthropic / API Claude : l'interface d'appel des modèles Claude, généralement Messages API.
- Claude Code : l'outil de programmation en ligne de commande d'Anthropic, qui appelle les modèles via l'API.
C'est pourquoi les termes « API Anthropic » et « API Claude » se rencontrent indifféremment dans la documentation : ils désignent le plus souvent la même interface de modèles.
2. Caractéristiques de l'API Anthropic
2.1 Messages API
L'interface principale est POST /v1/messages. Le corps de la requête contient :
model;max_tokens;messages;system(facultatif) ;temperature,top_p, etc. (facultatif) ;tools(facultatif).
2.2 En-têtes de requête
L'interface native nécessite généralement :
x-api-key: sk-...
anthropic-version: 2023-06-01
content-type: application/json
Selon les versions et les passerelles, un Bearer Token peut aussi être accepté ; la documentation fait foi.
2.3 Niveaux de modèles
Les niveaux courants de Claude sont :
| Niveau | Scénarios adaptés |
|---|---|
| Opus | Raisonnement complexe, agents à long parcours, problèmes difficiles |
| Sonnet | Développement quotidien, correction de bugs, revue de code |
| Haiku | Tâches simples, traitement par lots, coût maîtrisé |
Les noms de modèles et prix applicables sont ceux de la page Tarifs des modèles.
3. Exemple d'appel direct
export ANTHROPIC_API_KEY="sk-votre-cle"
curl "https://api.anthropic.com/v1/messages" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Explique en trois phrases Messages API"}
]
}'
Avec un SDK, initialisez le client selon le SDK Anthropic officiel ; n'appliquez pas le format de requête du SDK OpenAI.
4. Différences entre l'API Anthropic et l'API OpenAI
| Dimension | API Anthropic | API OpenAI |
|---|---|---|
| Chemin principal | /v1/messages |
/v1/chat/completions |
| En-tête d'authentification | x-api-key |
Authorization: Bearer |
| En-tête de version | anthropic-version |
Aucun |
| Format des messages | messages + system |
messages (avec rôle system) |
| Appels d'outils | tools |
tools / functions |
| SDK | SDK Anthropic | SDK OpenAI |
Les deux protocoles ne sont pas directement compatibles. De nombreuses passerelles proposent les deux entrées : compatibilité Anthropic pour Claude Code, compatibilité OpenAI pour le SDK et les outils OpenAI.
5. Deux méthodes d'accès depuis la Chine
Méthode A : accès direct officiel
URL de base : https://api.anthropic.com
Adaptée aux équipes ayant un accès stable à Anthropic, un compte officiel et un moyen de paiement.
Méthode B : ZSQH AI Gateway
- Entrée compatible Anthropic :
https://ai.zhongshangqihang.com(pour Claude Code, etc.) - Entrée compatible OpenAI :
https://ai.zhongshangqihang.com/v1(pour le SDK et les outils OpenAI)
Inscrivez-vous sur ZSQH AI Gateway, créez une clé et rechargez votre portefeuille pour commencer. Les noms de modèles applicables sont ceux de la page Tarifs des modèles.
6. Appeler Claude avec le SDK OpenAI
Si votre outil ne prend en charge que le protocole OpenAI, utilisez l'entrée compatible OpenAI de la passerelle :
from openai import OpenAI
client = OpenAI(
api_key="sk-votre-cle",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-5",
messages=[{"role": "user", "content": "Réponds seulement OK"}],
)
print(resp.choices[0].message.content)
Attention : il ne s'agit pas du protocole natif Anthropic ; les paramètres et capacités peuvent différer. Pour les appels d'outils natifs ou le cache, privilégiez l'entrée compatible Anthropic.
7. Comprendre la facturation
L'API Anthropic facture généralement les tokens d'entrée, les tokens de sortie et le cache. Points d'attention :
- les tokens de sortie sont généralement plus chers que les tokens d'entrée ;
- le contexte long amplifie les tokens d'entrée ;
- un cache touché réduit le coût, mais toutes les requêtes ne bénéficient pas d'un cache ;
- les prix unitaires varient fortement entre Opus, Sonnet et Haiku.
Les prix unitaires applicables sont ceux de la page Tarifs des modèles. Pour la méthode d'estimation, consultez Tarifs de Claude Code : abonnement ou API.
8. Questions fréquentes
API Anthropic et API Claude sont-elles identiques ?
Dans la plupart des contextes, il s'agit de la même interface de modèles, désignée par deux noms.
L'API Anthropic prend-elle en charge le format OpenAI ?
Pas nativement. Il faut passer par l'entrée compatible OpenAI d'une passerelle ou par une couche d'adaptation.
Comment appeler de manière stable depuis la Chine ?
Vous pouvez utiliser l'accès direct officiel si le réseau le permet, ou une passerelle accessible localement. Vérifiez la conformité des données et les conditions de service.
Quelle interface utilise Claude Code ?
Claude Code utilise Anthropic Messages API. Pour la configuration détaillée, consultez Clé API Claude : Console et passerelle.
Pour aller plus loin
Si vous avez besoin d'un accès stable depuis la Chine, d'une facturation unifiée ou d'un changement de modèle, vous pouvez créer un compte ZSQH AI Gateway, créer une clé de test et exécuter une requête Messages. Les modèles et prix applicables sont ceux de la page Tarifs des modèles.
À lire aussi :
