API Claude : clé, premier appel, modèles et prix

L’API Claude est la porte d’entrée des développeurs qui veulent intégrer Claude dans une application, un script ou un agent, plutôt que de l’utiliser dans claude.ai. La formation IA pour développeurs de Dyma consacre un chapitre aux API des LLM, de la création des clés à la tarification, puis un autre aux SDK pour les applications back-end. Ce guide va à l’essentiel : obtenir une clé, faire un premier appel, choisir un modèle et prévoir le coût. Tout a été vérifié le 11 novembre 2026 sur la documentation officielle, platform.claude.com. Dyma est indépendante et n’est pas affiliée à Anthropic.

API Claude ou application Claude : quelle différence ?

L’application Claude (claude.ai, l’application de bureau, les applications mobiles) est faite pour discuter avec le modèle. L’API est faite pour programmer : c’est votre code qui envoie les messages et qui lit les réponses, sans interface. Elle a son propre compte, la Claude Console, sur platform.claude.com, et sa propre facturation, mensuelle et à l’usage, en dollars.

Les abonnements de l’application (gratuit, Pro, Max, Ultra) sont détaillés dans notre guide des prix de Claude. Si votre but est de coder avec Claude dans votre terminal plutôt que de l’intégrer à un programme, c’est Claude Code qu’il vous faut, avec son propre guide des prix de Claude Code.

Obtenir une clé d’API en quatre étapes

1. Créez un compte sur la Claude Console, platform.claude.com, ou connectez-vous à celui que vous avez.
2. Générez une clé dans la page des clés de la Console (platform.claude.com/settings/keys). Rangez-la comme un mot de passe.
3. Exposez-la à votre code par la variable d’environnement ANTHROPIC_API_KEY : les SDK et la CLI la lisent automatiquement.
4. Ajoutez des crédits depuis la page Billing de la Console quand le crédit d’essai est épuisé, et fixez-y une limite de dépense.

export ANTHROPIC_API_KEY="votre-cle-ici"

Pour développer sur votre machine, la documentation recommande désormais une autre voie : la CLI officielle ant, qui vous connecte avec ant auth login. Les SDK et la CLI reprennent ensuite ces identifiants sans clé à copier. La clé reste la solution pour un serveur, une tâche planifiée ou une intégration continue.

Une clé ne se met jamais dans le code source ni dans un dépôt Git : elle se lit dans l’environnement, ou dans le gestionnaire de secrets de votre hébergeur.

Votre premier appel à l’API Claude

Un appel est une requête POST vers https://api.anthropic.com/v1/messages, avec trois en-têtes (la clé, la version de l’API et le type de contenu) et un corps JSON qui précise le modèle, le nombre maximal de jetons de la réponse et les messages.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      { "role": "user", "content": "Explique le pattern MVC en trois phrases." }
    ]
  }'

La réponse est un objet JSON. Le texte se trouve dans content, la raison de l’arrêt dans stop_reason, et le champ usage donne le nombre de jetons d’entrée et de sortie : c’est ce qui sera facturé.

Dans une vraie application, on passe par un SDK officiel, qui gère les en-têtes, les nouvelles tentatives et le streaming. En Python, après pip install anthropic :

import anthropic

client = anthropic.Anthropic()  # lit ANTHROPIC_API_KEY

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Explique le pattern MVC en trois phrases."}
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

En TypeScript, le paquet est @anthropic-ai/sdk (npm install @anthropic-ai/sdk) et l’appel a la même forme. La documentation cite aussi des SDK pour C# et d’autres langages.

Quel modèle choisir ?

Anthropic conseille de commencer par Claude Opus 5.5 pour la plupart des usages, et de réserver Claude Fable 5.2 aux raisonnements les plus exigeants et aux longues tâches d’agent. Les quatre modèles actuels lisent le texte et les images, utilisent des outils et acceptent jusqu’à 1 million de jetons de contexte.

Les identifiants sans date, comme claude-opus-5-5, désignent une version figée : votre application ne change pas de modèle sans que vous le décidiez. Les modèles plus anciens (Opus 5, Sonnet 5, Opus 4.8…) restent disponibles ; leurs dates de retrait sont publiées dans la documentation.

Combien coûte l’API Claude ?

Le prix se compte en jetons, des morceaux de texte : les jetons que vous envoyez (entrée) et ceux que Claude écrit (sortie), la sortie coûtant cinq fois plus cher. Un exemple avec Sonnet 5.5 : 1 000 requêtes de 2 000 jetons d’entrée et 500 jetons de sortie font 2 millions de jetons d’entrée (4 $) et 500 000 jetons de sortie (5 $), soit 9 $ au tarif de base.

La facturation suit l’usage réel du mois, en dollars ; un compte standard achète ses crédits par carte bancaire dans la page Billing, et suit sa consommation dans la Console. Pour compter les jetons d’une requête avant de l’envoyer, l’API propose un point d’accès dédié, /v1/messages/count_tokens.

Limites de dépense et de débit

Chaque organisation est placée dans un palier d’usage, qui fixe un plafond de dépense mensuel et des limites de débit (requêtes et jetons par minute). Le palier monte avec l’historique du compte ; un compte neuf peut démarrer dans un palier d’évaluation, plus bas.

Le plafond atteint, l’API répond par une erreur 429 jusqu’au premier jour du mois suivant, sauf passage à un palier supérieur. Vous pouvez fixer votre propre limite, plus basse, dans la page Billing : c’est la première chose à faire sur un compte de test.

Ce que vous pouvez construire ensuite

L’API Messages n’est que le début. La même API propose le traitement par lots (Message Batches), le comptage des jetons, la liste des modèles, l’envoi de fichiers réutilisables (Files) et la gestion de skills. Le modèle peut aussi appeler vos propres fonctions (tool use) ou des outils fournis par Anthropic, comme la recherche web et l’exécution de code. Et Claude est disponible par Amazon Bedrock, Google Cloud et Microsoft Foundry, si votre entreprise passe déjà par l’un de ces clouds.

C’est le programme des chapitres suivants de la formation IA pour développeurs : SDK côté back-end, agents, Model Context Protocol, sécurité et évaluation. Pour piloter Claude depuis votre terminal plutôt que depuis votre code, voyez la formation Claude Code ; pour l’application, la formation Claude.

Questions fréquentes