GuidesDéveloppement IA

Tuto : appeler l’API Claude depuis Node.js

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

index.tsPOSTClaude{ JSON }Clé côté serveurVotre serveur appelle l’API, jamais le navigateur
Votre serveur Node.js appelle l’API Claude avec une clé gardée côté serveur, et reçoit du JSON.

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 sortiemax_tokens borne la longueur et donc le coût.
  • Journal des tokensusage donne 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.

À lire ensuite

Tous les guides