Aller au contenu

S'exercerNiveau 3, Construire15 minutes

Premier appel à un modèle

Le premier appel à un modèle, en Python, chez OpenAI, Anthropic, Google ou Mistral : une dizaine de lignes, et ce que fait chacune.

Écrit le 7 octobre 2026 · Vérifié le 7 octobre 2026

Vous saurez

  • Installer la bibliothèque d'un éditeur et lui donner la clé
  • Envoyer une question à un modèle et lire sa réponse
  • Dire ce que fait chaque ligne du programme
  • Reconnaître les erreurs d'un premier appel

Dans le parcours

Construction

Étape 3 sur 12

Aussi dans : Premiers pas en développement

Sur cette page
  1. Rappel
  2. L'essentiel
  3. Objectif
  4. Données fournies
  5. Consignes
  6. Critères de réussite
  7. Indications
  8. Correction commentée
  9. Extensions
  10. Lectures suivantes
Rappel de la page précédente

Répondez de tête, puis ouvrez. Tokens, fenêtre de contexte et prix

1Pourquoi une conversation coûte-t-elle de plus en plus cher à chaque échange ?

Parce que le modèle relit tout l'historique à chaque échange : ce qu'il lit grandit à chaque tour. Le cache réduit le prix de ce qui est relu.

2Qu'est-ce qui doit tenir dans la fenêtre de contexte ?

Tout ce que le modèle lit d'un coup, instructions, documents, historique et question, et ce qu'il écrit en réponse.

L'essentiel
  1. Un appel tient en trois gestes : créer le client avec la clé, envoyer la demande, lire la réponse.
  2. Chaque éditeur a sa bibliothèque et sa forme de demande, mais le principe est le même.
  3. La clé se lit dans une variable d'environnement ; elle n'apparaît jamais dans le code.
  4. Le nom du modèle se choisit à chaque appel : c'est lui qui fixe le prix et la qualité.
  5. Les bibliothèques réessaient seules les erreurs passagères ; une erreur de budget, elle, ne passe pas en réessayant.
1

Objectif

Envoyer une question à un modèle depuis un programme Python, chez l'éditeur de votre choix, lire sa réponse, et savoir ce que fait chaque ligne.

Le code suit la documentation de chaque éditeur, lue le 7 octobre 2026, et les versions de leurs bibliothèques de ce jour. Il n'a pas encore été exécuté par Meridal : sa sortie n'est pas montrée.

2

Données fournies

Aucune : la question est dans le code. Il faut seulement une clé d'API chez l'éditeur choisi, avec un plafond de dépense.

3

Consignes

Trois gestes : créer le client avec la clé de l'éditeur, lue dans une variable d'environnement depuis le fichier .env, hors du code ; envoyer la demande, le nom du modèle et la question, à l'API de l'éditeur ; lire la réponse, le texte que le modèle a écrit. Le nom du modèle fixe le prix et la qualité ; une erreur passagère se réessaie seule, une erreur de budget non.
Un appel en trois gestes, la clé hors du code.

La bibliothèque openai, la clé dans OPENAI_API_KEY, le code de la documentation de l'éditeur, adapté sur deux points : la question en français et la lecture du fichier .env.

Terminal
uv add openai python-dotenv
appel.py
from dotenv import load_dotenv
load_dotenv()  # lit la clé dans le fichier .env

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6-luna",
    input="Explique en une phrase ce qu'est un token.",
)

print(response.output_text)
  1. from openai import OpenAI : importe le client de la bibliothèque d'OpenAI.
  2. client = OpenAI() : crée le client ; il lit tout seul la clé dans la variable OPENAI_API_KEY.
  3. client.responses.create(...) : envoie la demande à l'API Responses, qu'OpenAI recommande pour tout nouveau projet.
  4. model="gpt-6-luna" : le modèle qu'OpenAI présente pour les gros volumes à petit prix ; sa documentation prend gpt-6-astra, le plus capable.
  5. response.output_text : le texte de la réponse, tous morceaux réunis.
La sortieuv run appel.py

Pas encore exécuté par Meridal. Ce qu'on attend : une phrase en français qui définit un token.

4

Critères de réussite

5

Indications

Erreur d'authentification, ou code 401

CauseLa clé n'est pas lue : fichier .env absent, nom de variable faux, ou clé révoquée.

À faireVérifiez le nom exact de la variable pour l'éditeur, et que load_dotenv() vient avant la création du client.

Erreur 429

CauseTrop de demandes à la minute, ou le budget atteint. Chez OpenAI, une erreur 429 de crédits ou de dépense ne se règle pas en réessayant ; chez Anthropic, une 429 de plafond de dépense n'a pas d'en-tête retry-after.

À faireAttendre et réessayer pour une limite de débit ; relever le plafond pour une limite de dépense.

« ImportError » avec Mistral

CauseL'ancien import des versions 1.

À fairefrom mistralai.client import Mistral.

Erreur 529, 503 ou 504

CauseLe service est surchargé (529 chez Anthropic, 503 chez OpenAI et Mistral) ou la demande a pris trop de temps (504).

À faireRien à corriger dans le code : les bibliothèques réessaient déjà, deux fois chez OpenAI et Anthropic, jusqu'à quatre fois chez Google.

6

Correction commentée

Ouvrir la correction

Ce que les quatre programmes ont en communUn client, créé avec la clé lue dans l'environnement ; une demande, qui nomme le modèle et donne la question ; une réponse, dont on extrait le texte. Seuls les noms changent : responses.create et output_text chez OpenAI, messages.create et des blocs de texte chez Anthropic, interactions.create et output_text chez Google, chat.complete et choices[0].message.content chez Mistral.

Ce qu'on attend en sortieUne phrase en français qui définit un token, différente d'un modèle à l'autre et d'un lancement à l'autre : un modèle ne répond pas deux fois à l'identique.

Ce qui coûteQuelques dizaines de tokens lus, une ou deux centaines écrits : une fraction de centime, aux prix du marché des modèles.

7

Extensions

  • Les erreurs : entourez l'appel d'un try, et traitez à part la connexion, la limite de débit et les autres erreurs, comme le montre la page des erreurs d'OpenAI.
  • La conservation chez Google : l'API Interactions garde chaque échange par défaut, 55 jours sur l'offre payante, un jour sur l'offre gratuite ; le paramètre store à faux l'en empêche.
  • Les versions : uv fige la version de chaque bibliothèque dans uv.lock. En mai 2026, une version piégée de la bibliothèque de Mistral volait les clés dès l'import : une version figée, et mise à jour à dessein, protège de ce genre d'accident.
  • La suite : faire répondre un modèle dans un format imposé, pour qu'un programme puisse lire la réponse.
8

Lectures suivantes

↑ Plus général

Rien avant : c'est un point de départ.

Vous êtes ici

Premier appel à un modèle

↓ Plus concret

Rien avant : c'est un point de départ.

Tout le dossier « Construction et programmation »

Limites et sources

Le code suit la documentation des éditeurs et les versions de leurs bibliothèques du 7 octobre 2026 (openai 3.26.0, anthropic 1.12.0, google-genai 2.28.0, mistralai 3.1.0) ; il n'a pas encore été exécuté par Meridal.

Les noms de modèles changent souvent ; la page des modèles de chaque éditeur fait foi.

  1. OpenAI, Developer quickstart ; Anthropic, Get started ; Google, Gemini API quickstart ; Mistral, Send your first API request.
  2. Le relevé complet, avec chaque extrait de code : apprendre/recherches/2026-10-07-dev-appels-modeles.json.

Écrit par Meridal, avec l'aide de l'IA ; chaque fait vérifié à sa source et relu avant publication. Texte et schémas sous licence CC BY 4.0 : reprenez-les en citant Meridal. Le code sous licence MIT.

Service correspondant

Former vos équipes, et vous

Une demi-journée à deux journées, 550 € à 3 400 €

Voir le service

Un premier échange de 30 minutes

En visio et sans frais : vous décrivez votre situation, nous vous indiquons ce qui est réalisable, avec quels outils et pour quel ordre de prix. Vous pouvez aussi nous écrire ; chaque message reçoit une réponse écrite.