Intégrer l’API Claude à votre application

Une intégration de l’API Claude est simple au départ : l’installation d’un SDK et un appel authentifié. Mais sa capacité à fonctionner en production dépend de ce qui entoure cet appel : streaming, nouvelles tentatives, budgets de tokens et observabilité. Ce guide couvre l’ensemble du parcours, avec du code fonctionnel que vous pouvez adapter directement.

Authentification et première requête

Installez le SDK officiel (pip install anthropic ou npm install @anthropic-ai/sdk), définissez votre clé dans une variable d’environnement — jamais dans le code source — et effectuez un appel à l’API Messages pour valider la chaîne de traitement. L’API est versionnée à l’aide d’un en-tête anthropic-version que les SDK définissent pour vous.

Les clés fonctionnent de la même manière, qu’elles proviennent de la console Anthropic ou d’une passerelle compatible avec Anthropic comme AI Prime Tech (un service indépendant, non affilié à Anthropic) : la seule différence est la valeur de base_url utilisée pour construire votre client.

Choisir les modèles selon la tâche

Les intégrations qui codent un seul modèle en dur dépensent trop ou offrent des performances insuffisantes. Orientez les requêtes selon la tâche : Haiku 4.5 pour la classification, l’extraction et le routage ; Sonnet 4.6 pour la plupart des fonctionnalités du produit et la programmation ; Opus 4.8 lorsque la profondeur du raisonnement est au cœur du produit ; Fable 5 lorsque vous avez besoin de la fenêtre de contexte de 1M — retrouvez le comparatif complet dans <a href="/fr/learn/claude-api-models-compared/">Comparatif des modèles Claude</a>.

Faites du modèle une valeur de configuration, et non une constante — les noms des modèles changent tous les quelques mois, et vous voudrez tester les nouvelles versions en A/B sans effectuer de déploiement.

Streaming, délais d’expiration et nouvelles tentatives

Utilisez le streaming pour tout contenu qu’une personne suit à l’écran : les événements envoyés par le serveur transmettent les tokens au fur et à mesure de leur génération, réduisant la latence perçue de plusieurs secondes à moins d’une seconde. Les appels sans streaming avec une valeur max_tokens élevée risquent aussi davantage de dépasser les délais de lecture des proxys — un type de bug qui n’apparaît qu’en production.

Réessayez les requêtes ayant reçu une réponse 429 ou 5xx avec un délai exponentiel et une variation aléatoire, respectez les en-têtes retry-after lorsqu’ils sont présents et limitez le nombre total de tentatives. Traitez les erreurs 400 comme définitives — le contenu de la requête est lui-même incorrect (souvent une entrée trop volumineuse ; voir <a href="/fr/learn/claude-api-errors-troubleshooting/">Erreurs de l’API Claude</a>) et réessayer ne fait que consommer du quota.

La liste de vérification pour la production

Avant le lancement : budgets de tokens appliqués aux entrées comme aux sorties ; journalisation du coût de chaque requête (les données d’utilisation sont renvoyées dans chaque réponse) ; mise en cache des prompts activée pour les prompts système répétés ; modèle ou endpoint de secours en cas d’incident ; et examen des risques d’injection de prompt si les entrées utilisateur sont intégrées au prompt.

La plupart des difficultés d’intégration ne viennent pas de l’API elle-même, mais d’une croissance illimitée du contexte et d’un manque d’observabilité. Journalisez les tokens d’entrée et de sortie dès le premier jour pour éviter les surprises sur les coûts.

import os, anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url=os.environ.get("ANTHROPIC_BASE_URL", "https://aiprimetech.io"),
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize our launch plan in 3 bullets."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Questions fréquentes

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.