L'API Claude pour ceux qui construisent
- 01La requête, une seule porte d'entrée6 min
Toute interaction avec Claude passe par un seul point d'entrée HTTP, la requête POST /v1/messages, qui reçoit un tableau de tours et rend toujours la même structure de réponse.
- 02Des rôles qui tiennent, pas un pré remplissage qui casse7 min
Le pré remplissage du tour assistant, une pratique qui commençait la réponse de Claude à la place du modèle, est désormais rejeté par une erreur 400 sur les modèles courants ; une instruction system stable ou une sortie contrainte le remplacent.
- 03Les outils, Claude propose, le code dispose7 min
Un outil se déclare par un schéma nommé input_schema ; Claude ne l'exécute jamais lui même, il renvoie une demande d'usage que le code exécute avant de renvoyer le résultat pour que la conversation continue.
- 04Recevoir la réponse au fil de l'eau6 min
Le mode flux garde une seule connexion HTTP ouverte et livre le texte par fragments au fur et à mesure de sa génération, et le décompte cumulatif de jetons se lit dans le dernier événement message_delta reçu, jamais dans l'événement final message_stop.
- 05Deux leviers de coût, la mémoire en cache et le traitement par lot8 min
Un préfixe de requête marqué comme réutilisable coûte une fraction réduite du prix normal quand il est relu depuis le cache, et un ensemble de requêtes non urgentes traité en lot coûte moins cher qu'un traitement immédiat, deux réductions qui se cumulent entre elles et avec les autres modificateurs de prix.
- 06Compter avant d'envoyer, la fenêtre de contexte6 min
Un point de comptage dédié rend le nombre de jetons d'une requête avant de l'envoyer, et la fenêtre de contexte à comparer à ce chiffre n'est plus une valeur commune à toute une gamme de modèles, elle varie désormais fortement d'une famille à l'autre.
- 07Choisir un modèle, en changer, encaisser un refus9 min
Le choix d'un modèle est un compromis entre qualité, vitesse et coût qui se revoit à chaque nouvelle génération, et un refus renvoyé par un classificateur de sécurité se traite comme un cas normal du protocole, pas comme une panne.