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 :