Intégrer l’API Claude dans votre propre application

Intégrer l'API Claude dans votre propre application

Cet article explique comment intégrer l'API Claude dans votre application à l'aide du SDK Anthropic. Destiné aux développeurs qui souhaitent établir une connexion API fonctionnelle.

PRÉREQUIS - Node.js 18+ ou Python 3.8+ - Un compte Anthropic avec une clé API active (commençant par `sk-ant-`) - Accès à une interface en ligne de commande

ÉTAPES

1. Créez une clé API dans la console Anthropic Allez sur console.anthropic.com, connectez-vous et générez une nouvelle clé API. Enregistrez-la immédiatement — la clé n'est visible qu'une seule fois. N'utilisez jamais de codage en dur ; conservez la clé dans une variable d'environnement ou un gestionnaire de secrets comme AWS Secrets Manager.

2. Installez le SDK Anthropic npm install @anthropic-ai/sdk Pour Python : pip install anthropic

3. Définissez la variable d'environnement export ANTHROPIC_API_KEY="sk-ant-...votre-clé-ici..."

4. Effectuez un premier appel API avec l'API Messages Créez un fichier `test-claude.js` avec le code suivant :

import Anthropic from '@anthropic-ai/sdk';</p><p>   const client = new Anthropic();</p><p>   async function main() {
     const message = await client.messages.create({
       model: "claude-sonnet-4-20250514",
       max_tokens: 1024,
       messages: [{ role: "user", content: "Bonjour, qui êtes-vous ?" }],
     });
     console.log(message.content[0].text);
   }</p><p>   main().catch(console.error);

5. Exécutez le script node test-claude.js La sortie affiche la réponse de Claude.

6. Gérez l'historique de conversation via un tableau de messages Chaque appel API suivant contient l'historique complet. Utilisez un tableau pour suivre les messages :

const messages = [
     { role: "user", content: "Quelle est la capitale de la France ?" },
     { role: "assistant", content: "Paris." },
     { role: "user", content: "Et celle de l'Italie ?" }
   ];

7. Utilisez l'API de comptage de tokens pour estimer les coûts Ajoutez une vérification préalable avec le point de terminaison `count_tokens` :

const count = await client.messages.countTokens({
     model: "claude-sonnet-4-20250514",
     messages: messages
   });
   console.log(`Nombre de tokens : ${count.input_tokens}`);

8. Implémentez les lots de messages pour le traitement à grande échelle Pour le traitement par lots, utilisez l'API Batches asynchrone. Cela réduit les coûts jusqu'à 50 % :

const batch = await client.messages.batches.create({
     requests: [
       { custom_id: "req1", params: { model: "claude-haiku-3-5-20241022", max_tokens: 1024, messages: [{ role: "user", content: "Traduisez en anglais : Bonjour" }] }},
       { custom_id: "req2", params: { model: "claude-haiku-3-5-20241022", max_tokens: 1024, messages: [{ role: "user", content: "Traduisez en anglais : Merci" }] }}
     ]
   });

VÉRIFICATION Exécutez le script de test. Si vous obtenez une réponse valide de Claude (pas de `401 Unauthorized` ni de `404 Not Found`), l'intégration fonctionne.

PROBLÈMES COURANTS

1. La clé API ne fonctionne pas Vérifiez que la clé est toujours active dans la console Anthropic. Les clés expirent après 90 jours sans utilisation. Générez-en une nouvelle si nécessaire.

2. Limite de débit atteinte (429 Too Many Requests) Réduisez la fréquence des requêtes. Utilisez l'API de comptage de tokens pour estimer à l'avance si vous êtes proche d'une limite. Anthropic applique des limites par espace de travail — créez plusieurs espaces de travail pour différents cas d'utilisation.

3. Nom de modèle invalide (400 Bad Request) Vérifiez le nom exact du modèle dans la documentation Anthropic. Utilisez `claude-sonnet-4-20250514` pour Claude Sonnet 4.0 ou `claude-haiku-3-5-20241022` pour Claude Haiku 3.5. Les noms de modèles changent lors des mises à jour.

Quel modèle correspond à votre cas d'utilisation — puissant pour le raisonnement ou léger pour la rapidité ?

← Terug naar kennisbank