Brancher Claude, le modèle d'Anthropic, sur votre logiciel métier

Comment un programme dialogue-t-il avec Claude ?

Un programme dialogue avec Claude en envoyant des requêtes HTTP à l'API d'Anthropic. Chaque requête porte quatre en-têtes : la clé d'API (Authorization avec un jeton Bearer, ou x-api-key, encore accepté), la version de l'API (anthropic-version, par exemple 2023-06-01), le type de contenu, et l'identifiant d'espace de travail quand la clé en couvre plusieurs.

Au-delà de ces tailles, l'API répond par une erreur 413. Chaque réponse porte un en-tête request-id, à conserver dans vos journaux : c'est lui que le support d'Anthropic demande pour examiner un appel. Anthropic publie des kits de développement officiels (Python, TypeScript, C#, Go, Java, PHP, Ruby) qui gèrent les en-têtes et les nouvelles tentatives.

API directe ou passage par votre fournisseur cloud ?

Le choix de la porte d'entrée se fait avant le développement, car il conditionne la facturation, l'authentification et les fonctions disponibles.

Sur une plateforme cloud, l'authentification passe par le système de droits du fournisseur, et la disponibilité des fonctions varie : on vérifie la page de la plateforme pour chaque fonction dont le projet dépend.

Conservation et localisation des données : ce qu'écrit Anthropic

• Traitement par lots : selon la documentation du traitement par lots, les requêtes et les réponses d'un lot sont conservées jusqu'à 29 jours après sa création.
• API Files : les fichiers déposés restent disponibles jusqu'à leur suppression ou leur date d'expiration, et la page de l'API Files l'indique non éligible à la rétention zéro.
• Sorties structurées : la page qui les décrit les donne éligibles à la rétention zéro (ZDR).
• Règles générales : pour la conservation par défaut, l'usage éventuel des données et l'éligibilité de chaque fonction à la rétention zéro, ces pages renvoient à la page « API and data retention » d'Anthropic, à relire au moment du projet.
• Localisation : selon la page de tarifs d'Anthropic, le paramètre inference_geo prend la valeur « global », par défaut, ou « us », qui multiplie par 1,1 le prix des jetons à partir des modèles Claude 4.6. Cette page ne mentionne aucune option européenne pour l'API Claude en octobre 2026 ; Amazon Bedrock et Google Cloud appliquent leur propre tarification régionale.

Pour une PME européenne, cela n'interdit pas Claude, mais impose une analyse : quelles données partent, sont-elles nécessaires, et le traitement est-il inscrit au registre avec ses transferts hors de l'Union. Si le traitement en Europe est une exigence ferme, on compare avec les options régionales de la plateforme cloud de l'entreprise ou avec l'inférence régionale documentée par Mistral AI.

Niveaux, plafonds et erreurs 429

Anthropic place automatiquement chaque organisation dans un niveau d'usage, selon son historique et l'état de son compte : Start, Build, Scale, puis Custom, dont les limites se négocient avec l'équipe commerciale ; une organisation récente peut démarrer en niveau Evaluation, aux limites plus basses. Chaque niveau a un plafond de dépense mensuel : 500 dollars en Start, 1 000 dollars en Build, 200 000 dollars en Scale (valeurs relevées en octobre 2026). Le plafond atteint, l'usage est suspendu jusqu'au premier jour du mois suivant à 0 h UTC, sauf relèvement obtenu entre-temps, avec une erreur 429 sans en-tête retry-after.

Les limites de débit se comptent par classe de modèle en requêtes par minute, jetons d'entrée par minute et jetons de sortie par minute. L'algorithme du seau à jetons reconstitue la capacité en continu : 60 requêtes par minute peuvent être appliquées comme une requête par seconde, et une hausse brutale de trafic peut déclencher des limites d'accélération. Deux conséquences pour l'intégration :

• étaler les envois et monter en charge progressivement, plutôt que de lancer mille appels à 8 h ;
• mettre en cache le début commun des requêtes (consignes, catalogue) : pour la plupart des modèles, les jetons lus dans le cache ne comptent pas dans la limite d'entrée.

Pour le traitement par lots, le niveau Start admet 1 000 requêtes par minute et 200 000 requêtes en file, chaque lot restant limité à 100 000 requêtes. Des limites propres à chaque espace de travail permettent de séparer un usage de test de la production.

Quatre flux Claude dans un logiciel métier

1. Relire les contrats fournisseurs. Le service achats dépose un contrat en PDF ; le logiciel l'envoie à Claude, qui analyse le texte et le contenu visuel du PDF et relève durée, préavis de résiliation, pénalités et indexation, avec des citations qui renvoient aux passages du document. Attention : la documentation signale que les citations ne se combinent pas avec le format de sortie JSON (erreur 400) ; on fait donc deux appels, ou l'on choisit.
2. Préparer un mémoire technique. Pour un appel d'offres, le logiciel retrouve les réponses passées les plus proches de chaque question du cahier des charges et demande à Claude un premier jet, que le chargé d'affaires reprend.
3. Contrôler une nomenclature la nuit. Trente mille fiches articles partent dans un lot, chacune avec un custom_id ; les résultats arrivent dans un ordre quelconque, souvent en moins d'une heure, et sont rapprochés par cet identifiant. Les requêtes en erreur ou expirées ne sont pas facturées et repartent dans le lot suivant.
4. Interroger le logiciel en langage courant. Un responsable demande « quand a-t-on changé la courroie de la presse 4 ? ». Claude choisit l'outil historique_interventions que votre logiciel lui décrit ; en mode strict, le nom de l'outil et ses paramètres sont validés. Le logiciel exécute la recherche avec les droits de l'utilisateur, puis Claude formule la réponse. C'est le principe d'un agent IA, où la machine propose et le logiciel décide de ce qu'elle peut voir.

Sorties structurées : les limites à connaître avant de coder

Les sorties structurées de Claude passent par output_config.format avec un schéma JSON, ou par des outils déclarés en strict. Elles reposent sur un décodage contraint, mais la documentation détaille ses limites :

• par requête, au plus 20 outils stricts, 24 paramètres optionnels et 16 paramètres à plusieurs types ;
• pas de contraintes minimum, maximum ou de longueur dans le schéma : ces contrôles restent dans votre code ;
• un refus (stop_reason refusal) ou une réponse coupée par max_tokens peut ne pas respecter le schéma : le logiciel valide toujours la réponse ;
• la casse d'une valeur d'énumération peut différer : on compare sans tenir compte des majuscules ;
• le schéma JSON est mis en cache jusqu'à 24 heures après sa dernière utilisation, et la documentation exclut les données de santé protégées des noms de champs et des valeurs autorisées : on n'y place aucune donnée sensible.

Ce que YMHB Web met en place autour de l'API Claude

Les modèles d'Anthropic font partie des modèles de langage que YMHB Web intègre couramment, avec ceux d'OpenAI et de Mistral AI. L'organisation Anthropic et ses espaces de travail (test et production) sont ouverts au nom du client, les clés y sont créées avec une date d'expiration et rangées dans un coffre de secrets. Le code, les consignes, les schémas et le jeu d'essai sont livrés dans votre dépôt ; chaque appel est journalisé avec son request-id, sans données personnelles inutiles. L'appel au modèle est isolé : comparer Claude à OpenAI sur vos propres cas reste possible à tout moment. Notre offre est décrite sur la page intégrer un modèle de langage dans vos logiciels, et la méthode générale dans le guide intégrer l'IA dans un logiciel métier.