Comment intégrer l’API Claude à votre app

Pour intégrer l’API Claude, créez une clé API dans la Claude Console d’Anthropic, conservez-la comme secret côté serveur (habituellement ANTHROPIC_API_KEY), et appelez l’API Messages depuis une route de votre propre serveur à l’aide d’un des SDK officiels d’Anthropic. Chaque requête nomme un modèle, définit max_tokens (la réponse la plus longue que vous acceptez) et envoie la conversation sous forme de messages, avec vos instructions dans une consigne système distincte. Fixez un plafond de dépenses, diffusez les longues réponses en continu, et gérez les erreurs de limite de débit (429) et de surcharge (529) avec des nouvelles tentatives.

Ce guide couvre la configuration, un flux de requête sécurisé, des consignes pour un créateur d’IA et les erreurs à prévoir. Les détails sur Anthropic proviennent de sa documentation en date de septembre 2026. Pour le fonctionnement général des jetons et de la tarification, consultez comment utiliser les API de LLM.

Ce que vous pouvez construire avec

• Des assistants conversationnels et des widgets d’aide (comment créer une app de chatbot IA)
• Des résumés, des réécritures et des réponses rédigées
• L’extraction de champs à partir de documents, de courriels et de formulaires
• Des réponses aux questions à partir de votre propre contenu
• Des agents qui appellent les fonctions de votre app grâce à l’utilisation d’outils

Pour plus d’idées, consultez comment ajouter des fonctions d’IA à votre app.

L’API Messages en bref

Selon la référence de l’API d’Anthropic, une requête est un POST vers https://api.anthropic.com/v1/messages avec :

L’API est sans état : pour poursuivre une conversation, renvoyez les tours précédents à chaque requête. C’est pourquoi les longs échanges coûtent plus cher par message.

Anthropic publie des SDK officiels pour Python, TypeScript, C#, Go, Java, PHP et Ruby. Ils définissent les en-têtes, analysent les réponses et prennent en charge la diffusion en continu. Utilisez-en un plutôt que du HTTP brut, sauf si vous avez une bonne raison de ne pas le faire.

Choisir un modèle

Anthropic offre plusieurs modèles Claude qui font des compromis entre capacité, vitesse et prix, et la gamme évolue. Choisissez le plus petit modèle qui fait bien votre tâche, testez-le sur de vrais exemples, et conservez l’identifiant du modèle dans la configuration pour pouvoir le changer sans modifier le code. Consultez les pages des modèles et de la tarification d’Anthropic pour les options et les tarifs actuels.

Configurer votre compte

1. Connectez-vous à la Claude Console sur platform.claude.com et ajoutez un mode de paiement.
2. Créez une clé API. Gardez une clé par environnement (tests et production) pour pouvoir en révoquer une sans briser l’autre.
3. Fixez un plafond de dépenses. La page des erreurs d’Anthropic précise que lorsque l’utilisation atteint un plafond que vous avez défini, l’API renvoie une erreur 400; votre app doit donc afficher un message clair dans ce cas.
4. Vérifiez les limites de débit de votre compte dans la Console; elles sont mesurées par organisation.

Le flux de requête

1. L’utilisateur agit dans votre app : il envoie un message, clique sur « Résumer ».
2. Le navigateur appelle votre route serveur, jamais Anthropic directement.
3. Votre serveur vérifie que l’utilisateur est connecté et autorisé à utiliser la fonction, et applique une limite par utilisateur.
4. Il construit la requête : une consigne système avec vos règles, l’entrée de l’utilisateur et les données dont la tâche a besoin dans votre base de données.
5. Il appelle l’API Messages avec la clé provenant de l’environnement et un max_tokens raisonnable.
6. Il diffuse la réponse vers le navigateur et journalise l’utilisation des jetons à partir de la réponse.

Options et compromis

Consignes à donner à votre créateur d’IA

Une première fonction :

Ajoute un panneau « Poser une question sur ce document ». Il appelle une route serveur POST /api/ask qui vérifie que l’utilisateur est connecté et propriétaire du document, puis appelle l’API Messages de Claude avec le SDK officiel d’Anthropic et le secret ANTHROPIC_API_KEY. Lis l’identifiant du modèle dans le secret CLAUDE_MODEL. Consigne système : « Réponds seulement à partir du document fourni. Si la réponse n’y est pas, dis-le. » Envoie le texte du document et la question, règle max_tokens à 800, diffuse la réponse dans la page, et ne montre jamais la clé au navigateur.

Garde-fous et erreurs :

Limite chaque utilisateur à 20 questions par heure, suivies dans la base de données. Journalise les jetons d’entrée et de sortie de chaque réponse avec l’identifiant de l’utilisateur et l’identifiant de la requête. Pour les erreurs 429 ou 529, réessaie avec un délai exponentiel jusqu’à 3 fois en respectant l’en-tête retry-after, puis affiche « L’assistant est occupé, réessayez sous peu. » Si l’API signale une erreur de plafond de dépenses, affiche « Les fonctions d’IA sont suspendues » et avertis l’administrateur.

Erreurs à prévoir

Selon la documentation des erreurs d’Anthropic, voici celles que votre app rencontrera vraiment :

La documentation d’Anthropic indique que les SDK officiels réessaient automatiquement les échecs temporaires (erreurs de connexion, limites de débit et erreurs 5xx) deux fois par défaut, avec un délai exponentiel, et que ce comportement est configurable. Chaque réponse contient un en-tête request-id; journalisez-le pour que le soutien puisse retracer les problèmes.

Erreurs courantes

• Appeler l’API depuis le navigateur. Votre clé devient publique. Passez toujours par votre serveur. Consultez comment protéger vos clés API.
• Oublier que max_tokens est un plafond, et non une cible. Réglez-le selon les besoins de la fonction : trop bas, les réponses sont tronquées; trop haut, les réponses longues et coûteuses deviennent possibles.
• Mettre les règles dans le message de l’utilisateur. Les instructions stables doivent figurer dans la consigne system; les autorisations doivent être dans votre code.
• Envoyer toute la conversation indéfiniment. Coupez ou résumez les anciens tours à mesure que les conversations s’allongent.
• Aucun plafond de dépenses ni plafond par utilisateur.
• Coder en dur l’identifiant du modèle. Les modèles sont mis à jour et retirés.
• Ignorer la raison d’arrêt. Si la réponse s’est arrêtée parce qu’elle a atteint max_tokens, informez l’utilisateur ou augmentez le plafond.

Liste de vérification

• Clé API créée dans la Claude Console et conservée comme secret côté serveur
• Clés distinctes pour les tests et la production
• Plafond de dépenses fixé; message clair lorsqu’il est atteint
• Toutes les requêtes passent par votre serveur, avec vérification des autorisations
• La consigne système contient les règles; l’identifiant du modèle est configurable
• max_tokens défini par fonction; longues réponses diffusées en continu
• Limite de débit par utilisateur dans votre app
• Erreurs 429 et 529 gérées avec délai; identifiants de requête journalisés
• État d’erreur convivial qui ne bloque pas la page
• Testé avec des entrées vides, très longues et hostiles

Utiliser l’API Claude dans Mythex

Dans les apps que vous construisez sur Mythex, les fonctions Claude utilisent votre propre clé Anthropic et sont facturées à votre compte Anthropic, et non aux crédits de construction Mythex. Cela est distinct de l’agent Mythex qui écrit votre code. Ajoutez ANTHROPIC_API_KEY comme secret de projet via /secrets, les paramètres du projet ou la carte de secrets dans le clavardage, puis décrivez la fonction à l’aide de consignes semblables à celles ci-dessus. Publiez de nouveau après avoir modifié les secrets d’une app en ligne. Consultez Ajouter des fonctions d’IA avec vos propres clés API pour une consigne de départ. Si vous comparez les fournisseurs, comment intégrer l’API OpenAI couvre les mêmes éléments pour OpenAI.

Questions