API Claude : votre premier appel en 10 minutes

Vous voulez envoyer votre premier message a Claude via l’API, sans passer par l’interface de chat. Ce guide vous montre le chemin le plus court : creer une cle, faire un appel curl, puis le meme appel avec le SDK Python. Comptez 10 minutes.

API ou chat : quand choisir l’API

L’interface de chat sur claude.ai convient pour un usage manuel, une conversation a la fois. L’API est faite pour autre chose : integrer Claude dans votre propre application, automatiser une tache repetitive, ou brancher Claude sur vos donnees et vos outils.

• Utilisez le chat si vous testez une idee, redigez un texte ponctuel ou explorez une question seul.
• Utilisez l’API si vous voulez que Claude traite des messages envoyes par un programme (un site, un script, un bot) de facon repetee et automatisee.

Si vous developpez, l’API est le point d’entree naturel. C’est ce que nous allons mettre en place.

Obtenir votre cle API

Toute requete vers l’API doit s’authentifier avec une cle. Elle se cree dans la console Anthropic : console.anthropic.com.

1. Connectez-vous ou creez un compte sur la console.
2. Rendez-vous dans la section dediee aux cles API.
3. Generez une nouvelle cle et copiez-la immediatement (elle ne sera plus affichee en entier ensuite).

Securite de la cle

Cette cle donne acces a votre compte de facturation. Quelques regles simples :

• Ne la mettez jamais dans du code publie (GitHub, extension navigateur, application front-end visible par l’utilisateur).
• Stockez-la dans une variable d’environnement, pas en dur dans un fichier source.
• Revoquez-la immediatement depuis la console si vous pensez qu’elle a fuite.

Sous macOS ou Linux, definissez la variable dans votre terminal :

export ANTHROPIC_API_KEY="votre-cle-ici"

Le SDK et les exemples curl ci-dessous lisent cette variable automatiquement.

Votre premier appel (curl)

L’API Claude repose sur un seul point d’entree principal : POST https://api.anthropic.com/v1/messages. Chaque requete doit inclure trois en-tetes :

• x-api-key : votre cle API.
• anthropic-version : la version de l’API, actuellement 2023-06-01.
• content-type : toujours application/json.

Voici l’appel complet en ligne de commande :

curl https://api.anthropic.com/v1/messages 
  --header "x-api-key: $ANTHROPIC_API_KEY" 
  --header "anthropic-version: 2023-06-01" 
  --header "content-type: application/json" 
  --data '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Bonjour Claude, presente-toi en une phrase."}]
  }'

Le corps de la requete contient trois champs essentiels : model (quel Claude vous appelez), max_tokens (la longueur maximale de la reponse) et messages (la conversation, sous forme de liste avec un role et un contenu). Executez cette commande dans votre terminal : vous recevrez une reponse JSON en quelques secondes.

Le meme appel avec un SDK (Python)

En production, vous n’appellerez pas curl directement : vous utiliserez un SDK officiel. Anthropic en fournit pour plusieurs langages, dont le paquet Python anthropic et le paquet TypeScript/JS @anthropic-ai/sdk.

Installez le SDK Python :

pip install anthropic

Puis l’appel equivalent au curl precedent :

from anthropic import Anthropic
client = Anthropic()  # lit la cle depuis la variable d'environnement ANTHROPIC_API_KEY
message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Bonjour Claude"}],
)
print(message.content[0].text)

Le SDK gere pour vous les en-tetes, le format JSON et les erreurs reseau. C’est la methode recommandee des que vous integrez Claude dans un vrai projet plutot que dans un test ponctuel.

Comprendre la reponse et la facturation au token

La reponse de l’API contient plusieurs champs utiles :

• content : le texte genere par Claude, sous forme de liste de blocs.
• model : le modele qui a effectivement traite la requete.
• usage : le nombre de tokens consommes en entree et en sortie.

C’est ce champ usage qui determine votre facture. L’API Claude fonctionne a l’usage : vous payez les tokens envoyes (votre prompt) et les tokens recus (la reponse generee). Un token correspond a peu pres a un morceau de mot. Le tarif exact depend du modele choisi : Haiku est le moins cher, adapte aux taches simples et rapides ; Fable se situe tout en haut de gamme, pour les taches les plus exigeantes. Il n’y a pas d’abonnement fixe, seulement de la consommation.

Pour maitriser vos couts, fixez toujours un max_tokens raisonnable et testez d’abord sur un petit volume de requetes avant de deployer a grande echelle.

Choisir le modele et aller plus loin

Le parametre model accepte plusieurs identifiants selon vos besoins :

• claude-opus-4-8 : le modele recommande par defaut, un bon equilibre pour la plupart des usages.
• claude-sonnet-5 : une alternative pour des charges de travail plus intensives.
• claude-haiku-4-5 : le plus rapide et le moins cher, pour les taches simples ou a fort volume.
• claude-fable-5 : le modele le plus haut de gamme, pour le raisonnement le plus exigeant.

Si vous hesitez sur lequel utiliser pour votre projet, consultez notre guide pour choisir le bon modele Claude.

Une fois cet appel simple maitrise, l’etape suivante consiste generalement a enchainer plusieurs messages (une conversation), a donner acces a des outils a Claude, ou a traiter des documents. Si vous debutez completement avec Claude en dehors de l’API, notre article pour debuter avec Claude pose les bases utiles avant de coder.

Enfin, si votre objectif est de coder plus vite avec l’aide de Claude directement dans votre terminal ou votre editeur, plutot que d’appeler l’API vous-meme, jetez un oeil a Claude Code, l’outil en ligne de commande d’Anthropic.