claudemaster Commencer

Construire avec l’API · Chapitre 10

L’API Messages

Appeler Claude depuis ton code

L’essentiel

Requête minimale

Modèle, longueur max et messages.

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":"…","max_tokens":1024,
       "messages":[{"role":"user","content":"Salut"}]}'

SDK

Python et TypeScript officiels.

pip install anthropic
npm install @anthropic-ai/sdk

Rôles et système

messages alterne user / assistant. Le prompt système va dans system.

Lire la réponse

content contient des blocs, stop_reason dit pourquoi Claude s’est arrêté, usage compte les tokens.

Vocabulaire

/v1/messages
Endpoint principal
x-api-key
Clé API
max_tokens
Longueur max
system
Prompt système
stream
Réponse progressive
end_turn
Fin naturelle
usage
Tokens consommés

Teste-toi

  1. Quel endpoint sert à discuter avec Claude via l’API ?

    • POST /v1/messages
    • GET /v1/chat
    • POST /claude/talk
    • PUT /v1/ai
    Voir la réponse

    POST /v1/messages : L’API Messages : https://api.anthropic.com/v1/messages.

  2. Quel en-tête transporte ta clé API ?

    • x-api-key
    • Authorization: Bearer
    • api-token
    • claude-key
    Voir la réponse

    x-api-key : On envoie aussi anthropic-version et content-type: application/json.

  3. Quel paramètre est obligatoire en plus de model et messages ?

    • max_tokens
    • temperature
    • top_k
    • stream
    Voir la réponse

    max_tokens : max_tokens fixe la longueur maximale de la réponse.

  4. Quels rôles sont valides dans messages ?

    • user et assistant
    • user et system
    • human et bot
    • admin et user
    Voir la réponse

    user et assistant : Le prompt système se passe dans le paramètre system, pas comme un rôle.

  5. Dans la réponse, stop_reason: "max_tokens" signifie…

    • La réponse a été coupée car la limite de tokens est atteinte
    • Tout s’est bien terminé
    • Claude veut utiliser un outil
    • Erreur réseau
    Voir la réponse

    La réponse a été coupée car la limite de tokens est atteinte : end_turn = fin naturelle, tool_use = appel d’outil, max_tokens = coupé.

  6. Comment recevoir la réponse au fil de l’eau ?

    • "stream": true (Server-Sent Events)
    • "fast": true
    • Recharger la page
    • Ce n’est pas possible
    Voir la réponse

    "stream": true (Server-Sent Events) : Le streaming affiche le texte au fur et à mesure qu’il est généré.

Apprends en jouant, 5 minutes par jour

Leçons interactives, série quotidienne, XP et ligues : ClaudeMaster transforme ce guide en exercices. Gratuit, sur le web et sur Android.

Commencer gratuitement