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
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.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-versionetcontent-type: application/json.Quel paramètre est obligatoire en plus de model et messages ?
- max_tokens
- temperature
- top_k
- stream
Voir la réponse
max_tokens :
max_tokensfixe la longueur maximale de la réponse.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.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é.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é.