Faire votre première requête à l'Anthropic API est simple une fois que vous comprenez la configuration et la structure de base. Ce guide vous présente les étapes essentielles pour obtenir une réponse de Claude à vos requêtes à l'aide de Python.
Configurer votre environnement
Avant de faire des appels API, vous devez installer les packages requis et configurer votre clé API de manière sécurisée.
Tout d'abord, installez les dépendances nécessaires dans votre notebook Jupyter :
%pip install "anthropic<1" python-dotenvEnsuite, créez un fichier .env dans le même répertoire que votre notebook pour stocker votre clé API de manière sécurisée :
ANTHROPIC_API_KEY="your-api-key-here"Cette approche permet de garder votre clé API en dehors de votre code et d'éviter de la valider accidentellement dans le contrôle de version. Ajoutez toujours .env à votre fichier .gitignore.
Chargez les variables d'environnement et créez votre client API :
from dotenv import load_dotenv
load_dotenv()
from anthropic import Anthropic
client = Anthropic()
model = "claude-haiku-4-5"Conservez ce modèle et cette version de package pendant toute la durée du cours. Les versions plus récentes rejettent des paramètres enseignés dans les leçons suivantes, comme temperature et les messages d'assistant préremplis.
La fonction Create
L'essentiel des requêtes API repose sur la fonction client.messages.create(). Cette fonction nécessite trois paramètres clés :

- model - Le nom du modèle Claude que vous souhaitez utiliser
- max_tokens - Une limite de sécurité sur la longueur de la réponse (pas un objectif)
- messages - L'historique de conversation que vous envoyez à Claude
Le paramètre max_tokens agit comme un mécanisme de sécurité. Si vous le définissez sur 1000, Claude arrêtera de générer du texte après 1000 jetons même s'il a encore quelque chose à dire. Claude n'essaie pas d'atteindre cette limite - il écrit simplement ce qu'il estime approprié et s'arrête s'il atteint le maximum.
Comprendre les messages
Les messages représentent la conversation entre vous et Claude, de manière similaire à une application de chat. Il existe deux types de messages :

- Messages utilisateur - Contenu que vous souhaitez envoyer à Claude (rédigé par des humains)
- Messages assistant - Réponses générées par Claude
Chaque message est un dictionnaire avec un role (soit « user », soit « assistant ») et un content (le texte réel).
Faire votre première requête
Voici un exemple complet de requête à Claude :
message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
{
"role": "user",
"content": "What is quantum computing? Answer in one sentence"
}
]
)Lorsque vous exécutez ce code, Claude traite votre requête et renvoie un objet de réponse contenant le texte généré ainsi que des métadonnées sur la requête.
Extraire la réponse
L'objet de réponse contient de nombreuses informations, mais vous voulez généralement simplement le texte généré. Accédez-y en utilisant :
message.content[0].textCela vous donne un résultat propre et lisible comme : « Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers. »
Avec ces bases en place, vous pouvez commencer à expérimenter avec différentes requêtes et à créer des interactions plus complexes avec Claude.