GuidesDéveloppement IA
Tuto : appeler l’API Claude depuis Node.js
1. Installer
npm install @anthropic-ai/sdk
Dans le fichier .env du serveur, jamais dans le dépôt :
ANTHROPIC_API_KEY=sk-ant-...
CLAUDE_MODEL=identifiant-du-modele
2. Envoyer un message
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic(); // lit ANTHROPIC_API_KEY
const msg = await client.messages.create({
model: process.env.CLAUDE_MODEL!,
max_tokens: 1024,
system: 'Tu réponds en français, en trois phrases au plus.',
messages: [{ role: 'user', content: 'Explique ce qu’est un webhook.' }],
});
const text = msg.content.find((b) => b.type === 'text');
console.log(text?.text);
console.log(msg.usage.input_tokens, msg.usage.output_tokens);
3. Les bons réflexes
- Clé côté serveurDans une variable d’environnement, jamais dans le code du navigateur.
- Plafond de sortie
max_tokensborne la longueur et donc le coût. - Journal des tokens
usagedonne l’entrée et la sortie de chaque appel. - Une seule fonctionTous les appels passent par elle : changer de modèle devient trivial.
Ensuite : afficher la réponse en streaming et obtenir un JSON fiable.
Questions fréquentes
- Peut-on appeler l’API depuis le navigateur ?
- Non : la clé serait visible de tous. Le navigateur appelle votre serveur, qui appelle l’API.
- Quel modèle choisir ?
- La documentation d’Anthropic liste les modèles et leurs identifiants. Mettez l’identifiant dans une variable d’environnement pour en changer sans toucher au code.
- Que faire en cas d’erreur 429 ou de surcharge ?
- Le SDK réessaie automatiquement quelques fois. Au-delà, mettez la demande en file et réessayez plus tard.