Chargement
Chargement

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 :

bash
%pip install "anthropic<1" python-dotenv

Ensuite, 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 :

bash
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 :

python
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 :

L'appel client.messages.create avec des légendes identifiant ses trois paramètres, model, max_tokens et messages, listés ci-dessous.

  • 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 :

Fenêtre de chat où le message de l'utilisateur demande "Qu'est-ce que l'informatique quantique ?" et le message de l'assistant est la réponse de l'IA qui la définit.

  • 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 :

python
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 :

python
message.content[0].text

Cela 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.