Les concepts : ce qui se passe derrière un appel API
Endpoint, clé API, modèles, tokens, system prompt, streaming, vision, tool use, batch : la carte complète en une leçon.
🧠 Concept — claude.ai vs API : même cerveau, autre porte d'entrée
Quand tu utilises claude.ai, tu parles à Claude via une interface. Avec l'API, c'est TON code qui parle à Claude : tu envoies une requête HTTP à l'endpoint /v1/messages, tu reçois une réponse. C'est ce qui permet de mettre Claude dans un produit ou un script :
- classifier chaque ticket Intercom à son arrivée, sans humain dans la boucle ;
- extraire les champs d'un courrier mairie scanné, en batch, la nuit ;
- générer les descriptions des nouvelles stations pour le site.
La requête minimale contient : le modèle choisi, un max_tokens (plafond de longueur de réponse), et une liste de messages alternant user et assistant. En option mais presque toujours utile : un system prompt — le rôle permanent du modèle (« Tu es l'assistant support Electra… »), qui cadre TOUTES les réponses de la conversation.
La source de vérité pour tout ce qui suit : docs.claude.com/en/api/overview.
⚠️ Piège classique — La clé API est un SECRET. Un vrai.
Ta clé API, c'est ta carte bleue : quiconque la possède consomme des tokens facturés à Electra et peut lire ce que tes scripts envoient. Règles non négociables :
- Jamais en clair dans le code. Jamais. Même « juste pour tester ».
- Jamais commitée dans un dépôt Git — même privé, même 5 minutes. Chez Electra, GitGuardian scanne les dépôts et lèvera l'alerte, mais une clé exposée est une clé grillée : révocation immédiate obligatoire.
- Le bon réflexe : variable d'environnement (
ANTHROPIC_API_KEY) ou gestionnaire de secrets. Le SDK la lit tout seul, tu n'as même pas à la manipuler. - Une clé qui fuite → tu la révoques dans la console et tu en génères une neuve. Pas de « ça ira ».
🃏 Les 9 concepts de l'API (clique pour retourner)
🧠 Concept — La facturation : tu paies au token
Chaque appel est facturé aux tokens : ceux que tu envoies (input) + ceux que Claude produit (output). Conséquences pratiques :
- Volume élevé + tâche simple → modèle rapide et économique. Classifier un ticket ne demande pas le modèle le plus puissant ; multiplié par 10 000 tickets par mois, le choix du modèle change la facture d'un facteur 10 ou plus.
- Un system prompt de 3 pages renvoyé à chaque appel coûte à chaque appel : sois concis.
- Les tarifs par modèle : docs.claude.com. Aie toujours l'ordre de grandeur en tête avant de lancer un batch.
🎯 Vérifie le câblage
0/4 répondue · 0 juste1.Où doit vivre ta clé API Anthropic ?
2.Classifier 10 000 tickets Intercom par nuit : quel arbitrage de modèle ?
3.Le « tool use », c'est…
4.Ta réponse JSON arrive systématiquement tronquée au milieu. Premier suspect ?