Votre premier appel à l'API

Débutant

L'API permet à votre programme de dialoguer avec Claude. À la fin de cette leçon, vous aurez exécuté une véritable requête et compris exactement ce que fait chaque élément.

What you'll learn

Créer une clé API et la stocker en sécurité comme variable d'environnement
Installer le SDK officiel pour Python ou TypeScript (ou utiliser simplement cURL)
Envoyer votre première requête messages et lire la réponse de Claude
Comprendre les quatre champs essentiels : model, max_tokens, messages et system

Tout le parcours en trois étapes

Tout ce qui suit tient dans une séquence simple. Gardez cette carte à l'esprit au fil de la lecture.

Guided walkthrough1 of 3

Créez une clé dans la Console Anthropic et exportez-la comme variable d'environnement pour qu'elle ne se retrouve jamais dans votre code.

1. Obtenir une clé API

Créez-en une dans la Console Anthropic. Puis définissez-la comme variable d'environnement pour qu'elle ne se retrouve jamais dans votre code :

Exporter votre clé API

export ANTHROPIC_API_KEY="sk-ant-..."

Watch out

Ne commitez jamais votre clé. Gardez les clés dans des variables d'environnement ou un gestionnaire de secrets, jamais dans le contrôle de version. Voir la page Sécurité (/docs/security).

2. Installer le SDK

Choisissez votre langage. Le SDK lit automatiquement la clé depuis la variable d'environnement que vous venez de définir.

Python
TypeScript
cURL

Installation (Python)

pip install anthropic

Installation (TypeScript)

npm install @anthropic-ai/sdk

Rien à installer — il vous faut seulement curl.

3. Effectuer l'appel

Chaque requête est une liste de messages. Le modèle répond avec du content. Exécutez l'extrait pour votre langage et vous verrez Claude répondre à la question.

Python
TypeScript
cURL

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

console.log(message.content[0].text);

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-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

Ce qui vient de se passer

Vous avez envoyé quatre informations. Voici ce que chacune contrôle :

model — quel Claude utiliser. Ne le codez pas en dur à l'aveugle ; voir Choisir un modèle.
max_tokens — un plafond sur la longueur de la réponse (en tokens). Il ne définit pas la fenêtre de contexte.
messages — la conversation jusqu'ici. L'API est sans état : pour poursuivre une conversation, renvoyez tout l'historique à chaque fois.
system (optionnel) — une instruction de haut niveau qui définit le rôle de Claude pour l'appel.

Les quatre champs essentiels

Appuyez sur Entrée ou Espace pour retourner la carte. Utilisez les flèches gauche et droite pour naviguer entre les cartes.Terme affiché.

1 / 4

Pro tip

Comme l'API est sans état, une conversation multi-tours n'est qu'un tableau de messages qui grandit : ajoutez chaque réponse et renvoyez la liste complète à l'appel suivant.

Testez-vous

0/3

Que contrôle max_tokens ?
Comment poursuivre une conversation multi-tours avec l'API ?
Où votre clé API devrait-elle se trouver ?

Key takeaways

Trois étapes : obtenir une clé, installer le SDK, envoyer une requête messages.
Stockez la clé dans ANTHROPIC_API_KEY pour que le SDK la lise automatiquement et qu'elle n'entre jamais dans votre code.
Une requête est une liste de messages ; la réponse revient dans content.
L'API est sans état : renvoyez tout l'historique de la conversation pour la poursuivre.
model, max_tokens, messages et system sont les champs vers lesquels vous vous tournerez en premier.

Ensuite

Choisir le bon modèle & estimer le coût → Choisir un modèle · Tokens et tarification
Streamer les réponses et tenir une conversation → Streaming & multi-tours
Laisser Claude appeler vos fonctions → Utilisation des outils
Extraits prêts pour la production → Extraits d'API

Tout le parcours en trois étapes​

1. Obtenir une clé API​