Claude Academy
Chargement

Effectuer une requête

Leçon 315 min

Effectuer votre première requête à l'API Anthropic est simple une fois que vous comprenez la configuration et la structure de base. Ce guide passe en revue les étapes essentielles pour amener Claude à répondre à vos requêtes en utilisant Python.

Configuration de votre environnement

Avant d'effectuer des appels API, vous devez installer les paquets 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"

La fonction Create

Le cœur de l'exécution des requêtes API est 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 la conversation que vous envoyez à Claude

Le paramètre max_tokens agit comme un mécanisme de sécurité. Si vous le définissez à 1000, Claude arrêtera de générer du texte après 1000 jetons même s'il a encore des choses à dire. Claude n'essaie pas d'atteindre cette limite - il écrit simplement ce qu'il juge 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 - Le contenu que vous souhaitez envoyer à Claude (rédigé par des humains)
  • Messages assistant - Les réponses que Claude a générées

Chaque message est un dictionnaire avec un role (soit « user », soit « assistant ») et un content (le texte proprement dit).

Effectuer votre première requête

Voici un exemple complet d'exécution d'une 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.

Extraction de la réponse

L'objet de réponse contient beaucoup d'informations, mais vous souhaitez généralement obtenir uniquement le texte généré. Accédez-y en utilisant :

python
message.content[0].text

Cela vous donne un résultat clair 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 à construire des interactions plus complexes avec Claude.