Votre premier appel d'API : Python et les bases

Cinq lignes de code suffisent à envoyer une question à un modèle d'IA qui tourne dans un data center quelque part, et à récupérer une réponse dans votre terminal. Pas de site web, pas de zone de chat, juste votre code qui parle directement au modèle. C'est ça, un appel d'API, et à la fin de cette leçon vous en aurez fait un.

Ce que « appel d'APIAPIApplication Programming Interface : une interface standardisée qui permet aux applications de communiquer et d'échanger des données sans connaître leur fonctionnement interne respectif.Voir la définition complète → » veut dire concrètement

Une API (Application Programming Interface) est une porte qu'un logiciel ouvre pour que d'autres logiciels puissent lui parler. Quand vous utilisez ChatGPT dans votre navigateur, c'est vous qui tapez. Avec une API, c'est votre *code* qui tape et qui lit.

Voyez ça comme une commande au restaurant :

• Vous (votre code) passez une commande : « un message pour l'IA ».
• La cuisine (les serveurs du fournisseur d'IA) fait le travail.
• Un serveur rapporte le plat : « la réponse de l'IA ».

Vous ne voyez jamais la cuisine. Vous avez seulement besoin de savoir commander et de savoir ce qui revient.

Un SDK (Software Development Kit) est une petite boîte à outils que le fournisseur vous donne pour que votre code passe cette commande sans complication. Au lieu d'écrire des requêtes web brutes, vous appelez une fonction propre. Nous allons en utiliser une ci-dessous.

Ce dont vous avez besoin au départ

Trois choses :

1. Python installé. Python est un langage de programmation réputé pour sa lisibilité. Si vous ne l'avez pas, la page de téléchargement officielle de Python vous guide pas à pas.
2. Une clé d'API. C'est un mot de passe secret qui dit au fournisseur « cette requête vient de moi, facturez mon compte ». Vous la crcrLe pourcentage de visiteurs ou de prospects qui réalisent une action attendue (achat, inscription, formulaire de contact), calculé en divisant les conversions par le nombre total d'opportunités.Voir la définition complète →éez dans le dashboard de votre fournisseur (OpenAI, Anthropic ou Google).
3. Le SDK installé. Une seule commande suffit.

Un mot sur le coût : les appels d'API ne sont pas gratuits, mais ils sont peu chers pour apprendre. Quelques centaines de messages de test coûtent généralement moins d'un dollar. Les nouveaux comptes incluent souvent un petit crédit gratuit.

Installer le SDK

Ouvrez votre terminal (le panneau de contrôle en mode texte de votre ordinateur) et lancez l'une de ces commandes :

# Pour Claude d'Anthropic
pip install anthropic

# Pour les modèles ChatGPT d'OpenAI
pip install openai

# Pour Gemini de Google
pip install google-genai

pip est l'installeur de Python. Il récupère la boîte à outils sur internet et la met en place. Vous ne le faites qu'une fois.

Votre premier appel, ligne par ligne

Voici un programme complet et exécutable utilisant Claude. Enregistrez-le sous first_call.py.

import anthropic

client = anthropic.Anthropic(api_key="YOUR_KEY_HERE")

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[
        {"role": "user", "content": "Explain what an API is in one sentence."}
    ],
)

print(response.content[0].text)

Maintenant, lisons chaque ligne.

import anthropic

Ceci charge la boîte à outils que vous avez installée. « Import » veut dire « amène cet outil dans mon programme pour que je puisse l'utiliser ».

client = anthropic.Anthropic(api_key="YOUR_KEY_HERE")

Ceci met en place votre connexion au fournisseur. client n'est qu'un nom que nous avons choisi. La api_key est votre mot de passe secret. Collez votre vraie clé entre les guillemets.

response = client.messages.create(

C'est la commande à proprement parler. Vous dites au client : « crée un nouvel échange de messages ». Tout ce qui est entre parenthèses, ce sont les détails de votre commande. La réponse est stockée dans response.

model="claude-sonnet-4-5"

Quel modèle d'IA doit répondre. Les fournisseurs en proposent plusieurs, avec un arbitrage entre vitesse et puissance. Sonnet est un choix solide et équilibré en 2026.

max_tokens=200

Un tokentokenUn token est l'unité de base de texte que traitent les modèles de langage : le plus souvent un fragment de mot, un mot entier ou un signe de ponctuation, plutôt qu'un simple caractère.Voir la définition complète → est un fragment de texte, à peu près trois quarts de mot. Ceci plafonne la longueur de la réponse, pour qu'elle ne parte pas dans tous les sens (et ne fasse pas grimper votre facture). 200 tokens, c'est un court paragraphe.

messages=[ ... ]

La conversation elle-même. Chaque message a un role et un content. Ici le rôle est "user" (c'est vous), et le contenu est votre question.

print(response.content[0].text)

La réponse revient enveloppée dans une structure. Cette ligne en extrait le texte brut et l'affiche à l'écran. content[0] signifie « le premier élément de la réponse », et .text signifie « donne-moi les mots ».

Lancez-le depuis votre terminal :

python first_call.py

Vous devriez voir quelque chose comme : *« Une API est un ensemble de règles qui permet à un programme de demander des services ou des données à un autre. »*

Voilà. Vous venez de parler à un modèle d'IA en code.

La même idée, un autre fournisseur

Les trois grands fournisseurs fonctionnent presque à l'identique. Voici la version OpenAI, pour voir à quel point les différences sont minces :

from openai import OpenAI

client = OpenAI(api_key="YOUR_KEY_HERE")

response = client.responses.create(
    model="gpt-5",
    input="Explain what an API is in one sentence."
)

print(response.output_text)

Même structure : on met en place un client, on envoie un message, on affiche la réponse. Une fois que vous en comprenez un, vous les comprenez tous. Le SDK Gemini de Google suit le même schémamaUtiliser un logiciel pour automatiser les tâches et campagnes marketing répétitives, afin de personnaliser à grande échelle sur des canaux comme l'email, le web et le social.Voir la définition complète → avec google-genai.

Gardez votre clé secrète

Ne collez jamais votre clé d'API dans un endroit public : ni dans un dépôt GitHub, ni dans un document partagé, ni dans une capture d'écran. Quiconque a votre clé peut dépenser votre argent.

La bonne habitude consiste à stocker la clé dans une variable d'environnement (un réglage que votre ordinateur conserve en dehors de votre code). Votre code la lit alors sans que la clé apparaisse jamais dans le fichier :

import os
import anthropic

client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

os.environ["ANTHROPIC_API_KEY"] signifie « va chercher la valeur que j'ai enregistrée sous ce nom ». Vous définissez cette valeur une fois dans votre terminal ou dans les réglages système, et votre code reste propre. Commencez avec la clé collée en dur pour votre tout premier test si vous voulez, mais passez à cette méthode avant de partager quoi que ce soit.

Comment structurer un petit projet d'IA

Une fois votre premier appel fonctionnel, l'état d'esprit passe de « j'ai envoyé un message » à « je construis quelque chose ». Quelques principes évitent les ennuis aux débutants.

Commencez par un appel qui fonctionne, puis changez une seule chose

Faites tourner le script de base avant d'ajouter quoi que ce soit. Ensuite, faites une modification à la fois : un prompt plus long, un autre modèle, un max_tokens plus élevé. Si quelque chose casse, vous savez exactement ce qui en est la cause.

Mettez votre prompt dans une variable

À mesure que votre prompt grossit, sortez-le pour qu'il soit facile à modifier :

prompt = """
You are a helpful assistant.
Summarize the following review in one sentence,
then rate the sentiment from 1 to 5.

Review: The coffee was great but the wait was 25 minutes.
"""

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[{"role": "user", "content": prompt}],
)

print(response.content[0].text)

C'est là que les appels d'API deviennent utiles. Vous pouvez désormais injecter des centaines d'avis en bouclant dessus, ce que vous ne pourriez jamais faire à la main dans la fenêtre de chat.

Ajoutez une instruction « system » pour un comportement constant

Un system promptsystem promptLes instructions cachées qui définissent le comportement d'un assistant IA avant toute question : son rôle, son ton, ses limites et ses règles.Voir la définition complète → définit le rôle et les règles de l'IA pour toute la conversation. Il garde chaque réponse alignée sur votre marque :

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    system="You are a concise assistant. Always answer in under 30 words.",
    messages=[{"role": "user", "content": "What is an API?"}],
)

Remarquez que le champ system est séparé de messages. Le system prompt est votre consigne permanente ; les messages sont la conversation en direct.

Attendez-vous à ce que ça casse, et lisez l'erreur

Les erreurs sont normales. Les deux plus courantes chez les débutants :

• Erreur d'authentification : votre clé est fausse, absente, ou comporte des espaces en trop. Vérifiez-la à nouveau.
• Erreur de rate limit : vous avez envoyé trop de requêtes trop vite. Attendez un instant et réessayez.

Le message d'erreur vous dit presque toujours de laquelle il s'agit. Lisez-le lentement avant de modifier du code.

Consultez la documentation officielle, pas des forums au hasard

La documentation des fournisseurs est tenue à jour et contient des exemples à copier-coller pour chaque modèle. Le guide de démarrage de l'API d'Anthropic est une référence claire. Mettez l'équivalent de votre fournisseur dans vos favoris.

Pourquoi c'est important

La fenêtre de chat est très bien pour des questions ponctuelles. L'API, c'est pour le *travail répétable* : résumer 500 tickets de support, taguer un tableur, rédiger des emails personnalisés, construire un petit outil qu'un collègue pourra utiliser. À partir du moment où vous pouvez appeler le modèle depuis du code, l'IA cesse d'être un site web que vous visitez et devient une brique que vous contrôlez.

Points clés

• Un appel d'API, c'est votre code qui passe commande auprès de l'IA : vous envoyez un message, les serveurs du fournisseur font le travail, vous recevez une réponse. Le SDK est la boîte à outils qui rend la commande simple.
• Cinq lignes suffisent pour démarrer : importer le SDK, créererLe rapport entre les interactions (likes, commentaires, partages) et le reach d'un contenu, utilisé pour mesurer la réaction de l'audience au regard du nombre de personnes touchées.Voir la définition complète → un client avec votre clé, envoyer un message, afficher la réponse. Faites-le tourner avant d'ajouter quoi que ce soit.
• Protégez votre clé d'API comme un mot de passe. Déplacez-la dans une variable d'environnement avant de partager du code, pour qu'elle n'apparaisse jamais dans un fichier.
• Changez une chose à la fois. Sortez votre prompt dans une variable, ajoutez une instruction system pour un comportement constant, et lisez attentivement les messages d'erreur quand ça casse.
• Passez à l'API quand vous avez du travail répétable, comme traiter de nombreux éléments d'un coup, ce que la fenêtre de chat ne peut pas faire pour vous.