Comment intégrer l'API Claude dans votre application

Pour intégrer l'API Claude, créez une clé API dans la Claude Console d'Anthropic, stockez-la comme secret côté serveur (généralement ANTHROPIC_API_KEY), et appelez la Messages API depuis une route de votre propre serveur à l'aide d'un des SDK officiels d'Anthropic. Chaque requête indique un model, définit max_tokens (la longueur maximale de réponse que vous acceptez) et envoie la conversation sous forme de messages, avec vos instructions dans un system prompt séparé. Définissez un plafond de dépense, diffusez les réponses longues en streaming et gérez les erreurs de limitation 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 prompts pour un créateur d'applications IA et les erreurs à anticiper. Les informations sur Anthropic proviennent de sa documentation de septembre 2026. Pour le fonctionnement général des tokens et de la tarification, consultez d'abord comment utiliser les API LLM.

Ce que vous pouvez construire avec

Des assistants conversationnels et des widgets d'aide (comment créer une application chatbot IA)
Des résumés, des reformulations et des réponses rédigées
L'extraction de champs à partir de documents, d'e-mails et de formulaires
Des réponses à des questions à partir de votre propre contenu
Des agents qui appellent les fonctions de votre application grâce à l'utilisation d'outils (tool use)

Pour d'autres idées, consultez comment ajouter des fonctionnalités IA à votre application.

La Messages API 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ément	Description
En-tête `x-api-key`	Votre clé API
En-tête `anthropic-version`	La version de l'API, par exemple `2023-06-01`
`model` (obligatoire)	Le modèle Claude à utiliser
`max_tokens` (obligatoire)	Le nombre maximal de tokens que la réponse peut contenir ; le modèle peut s'arrêter plus tôt
`messages` (obligatoire)	La conversation : des tours `user` et `assistant` en alternance
`system` (facultatif)	Instructions qui s'appliquent à toute la conversation
`stream` (facultatif)	Mettre à `true` pour recevoir la réponse au fur et à mesure qu'elle est écrite, via des événements envoyés par le serveur

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

Anthropic publie des SDK officiels pour Python, TypeScript, C#, Go, Java, PHP et Ruby. Ils gèrent les en-têtes, l'analyse des réponses et le streaming. Utilisez-en un plutôt que du HTTP brut, sauf raison particulière.

Choisir un modèle

Anthropic propose plusieurs modèles Claude qui arbitrent entre capacités, vitesse et prix, et la gamme évolue. Choisissez le plus petit modèle qui réalise bien votre tâche, testez-le sur des exemples réels, et conservez l'identifiant du modèle dans la configuration pour pouvoir en changer sans modifier le code. Consultez les pages des modèles et des tarifs d'Anthropic pour les options et les tarifs actuels.

Configurer votre compte

Connectez-vous à la Claude Console sur platform.claude.com et ajoutez un moyen de paiement.
Créez une clé API. Gardez une clé par environnement (test et production) afin de pouvoir en révoquer une sans casser l'autre.
Définissez un plafond de dépense. La page des erreurs d'Anthropic indique que, lorsque l'usage atteint un plafond que vous avez fixé, l'API renvoie une erreur 400 ; votre application doit donc afficher un message clair dans ce cas.
Consultez les limites de débit de votre compte dans la Console ; elles sont mesurées par organisation.

Le flux de requête

L'utilisateur agit dans votre application : il envoie un message, clique sur « Résumer ».
Le navigateur appelle votre route serveur, jamais directement Anthropic.
Votre serveur vérifie que l'utilisateur est connecté et autorisé à utiliser la fonctionnalité, et applique une limite par utilisateur.
Il construit la requête : un prompt système avec vos règles, la saisie de l'utilisateur et les données nécessaires à la tâche, issues de votre base.
Il appelle la Messages API avec la clé issue de l'environnement et un max_tokens raisonnable.
Il diffuse la réponse vers le navigateur et journalise la consommation de tokens renvoyée dans la réponse.

Options et compromis

Décision	Choix simple	Pour aller plus loin
Streaming	Attendre la réponse complète	Utiliser le streaming pour le chat et tout contenu long ; Anthropic recommande le streaming ou les lots pour les requêtes longues
Format de sortie	Texte brut	Sortie JSON structurée lorsque votre code doit lire des champs
Vos données	Inclure l'enregistrement pertinent	Recherche dans votre contenu lorsqu'il y en a trop (qu'est-ce que le RAG)
Actions	Le modèle se contente d'écrire du texte	Utilisation d'outils, où le modèle demande à votre code d'exécuter une fonction que vous définissez
Traitement en masse, non urgent	Boucler sur les éléments	La Message Batches API, que vous soumettez puis interrogez pour récupérer les résultats

Prompts à donner à votre créateur d'applications IA

Une première fonctionnalité :

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 la Messages API 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. Prompt système : « Réponds uniquement à partir du document fourni. Si la réponse n'y figure pas, dis-le. » Envoie le texte du document et la question, fixe max_tokens à 800, diffuse la réponse vers la page en streaming, et n'expose 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 tokens d'entrée et de sortie de chaque réponse avec l'identifiant de l'utilisateur et l'identifiant de la requête. En cas d'erreur 429 ou 529, réessaie avec un backoff exponentiel jusqu'à 3 fois en respectant l'en-tête retry-after, puis affiche « L'assistant est occupé, réessayez dans un instant. ». Si l'API signale une erreur de plafond de dépense, affiche « Les fonctionnalités IA sont en pause » et alerte l'administrateur.

Erreurs à anticiper

D'après la documentation des erreurs d'Anthropic, voici celles que votre application rencontrera réellement :

Code	Type	Action à mener
400	`invalid_request_error`	Corriger la requête ; cette erreur est aussi renvoyée lorsque vous atteignez un plafond de dépense que vous avez défini
401	`authentication_error`	Vérifier que la clé est présente, correcte et non révoquée
413	`request_too_large`	Envoyer moins de données ; la Messages API accepte jusqu'à 32 Mo par requête
429	`rate_limit_error`	Temporiser et réessayer en respectant `retry-after`
500	`api_error`	Réessayer avec backoff ; contacter le support avec l'identifiant de la requête si le problème persiste
529	`overloaded_error`	Trafic temporairement élevé pour l'ensemble des utilisateurs ; temporiser et réessayer

La documentation d'Anthropic indique que les SDK officiels relancent automatiquement les échecs transitoires (erreurs de connexion, limites de débit et erreurs 5xx) deux fois par défaut, avec un backoff exponentiel, et que ce comportement est configurable. Chaque réponse contient un en-tête request-id ; journalisez-le pour que le support puisse retrouver l'origine des problèmes.

Erreurs fréquentes

Appeler l'API depuis le navigateur. Votre clé devient publique. Passez toujours par votre serveur. Voir comment protéger vos clés API.
Oublier que max_tokens est un plafond, pas une cible. Réglez-le sur ce dont la fonctionnalité a besoin : trop bas, les réponses sont tronquées ; trop haut, les réponses risquent d'être longues et coûteuses.
Mettre les règles dans le message utilisateur. Les instructions stables doivent figurer dans le prompt system ; les permissions doivent être dans votre code.
Envoyer indéfiniment toute la conversation. Réduisez ou résumez les anciens tours à mesure que les conversations s'allongent.
Absence de plafond de dépense ou de limite par utilisateur.
Coder en dur l'identifiant d'un 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, prévenez l'utilisateur ou augmentez le plafond.

Liste de contrôle

Clé API créée dans la Claude Console et stockée comme secret côté serveur
Clés distinctes pour les tests et la production
Plafond de dépense défini ; message clair lorsqu'il est atteint
Toutes les requêtes passent par votre serveur avec contrôle des permissions
Les règles sont dans le prompt système ; l'identifiant du modèle est configurable
max_tokens défini par fonctionnalité ; réponses longues diffusées en streaming
Limite de débit par utilisateur dans votre application
Erreurs 429 et 529 gérées avec backoff ; identifiants de requête journalisés
État d'erreur convivial qui ne casse pas la page
Testé avec des saisies vides, très longues et malveillantes

Utiliser l'API Claude dans Mythex

Dans les applications que vous créez sur Mythex, les fonctionnalités Claude utilisent votre propre clé Anthropic et sont facturées sur votre compte Anthropic, et non sur vos crédits de création Mythex. C'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 chat, puis décrivez la fonctionnalité avec des prompts comme ceux ci-dessus. Republiez après avoir modifié des secrets sur une application en ligne. Pour un prompt de départ, consultez Ajouter des fonctionnalités IA avec vos propres clés API. Si vous comparez les fournisseurs, comment intégrer l'API OpenAI couvre les mêmes points pour OpenAI.

Questions

Comment obtenir une clé API Claude ?

Connectez-vous à la Claude Console sur platform.claude.com, configurez la facturation et créez une clé API. Stockez-la comme secret côté serveur, nommé par convention ANTHROPIC_API_KEY, et ne la mettez jamais dans le code du navigateur.

De quoi une requête vers l'API Claude a-t-elle besoin ?

En septembre 2026, la référence de la Messages API d'Anthropic indique trois champs obligatoires dans le corps de la requête : model, max_tokens et messages. Les appels HTTP directs nécessitent aussi les en-têtes x-api-key et anthropic-version ; les SDK officiels les renseignent à votre place.

Qu'est-ce qu'une erreur 529 de l'API Claude ?

La page des erreurs d'Anthropic décrit le 529 comme overloaded_error : l'API est temporairement surchargée à cause d'un trafic élevé pour l'ensemble des utilisateurs. Réessayez avec un backoff exponentiel. Les SDK officiels relancent automatiquement certaines erreurs transitoires.

Puis-je utiliser Claude avec du code écrit pour le SDK OpenAI ?

Anthropic documente une couche de compatibilité avec le SDK OpenAI, qui permet d'utiliser Claude via l'interface du SDK OpenAI. Pour du nouveau code, ses propres SDK donnent accès aux fonctionnalités spécifiques à Claude, ce qui en fait en général le meilleur point de départ.