# L'API d'OpenAI : clé, API Responses, outils, modèles et prix

> Brancher GPT-6.2 Astra ou Sol dans un programme : créer une clé, appeler l'API Responses, ajouter des outils, régler l'effort, lire la facture en dollars.

- Niveau : Expert
- Thème : Code
- Durée : 16 minutes
- Systèmes : Mac, Windows, Linux
- Disponible en France : L'API est ouverte en France ; le traitement des données en Europe existe pour GPT-6.2 Astra et Sol en modes Standard, Fast et Batch, avec 10 % de supplément, mais pas en Ultrafast. (https://developers.openai.com/api/docs/guides/latest-model, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/openai-api/

L'API d'OpenAI met ses modèles à disposition d'un programme : un site, une appli, un script, un agent. Elle se règle et se paie à part de ChatGPT, sur platform.openai.com, au nombre de jetons lus et écrits, en dollars. Un abonnement ChatGPT n'en donne pas l'usage, et une clé d'API ne donne pas accès à ChatGPT.

![Le trajet d'une requête à l'API Responses, des paramètres envoyés à la facture, d'après la documentation développeur d'OpenAI lue le 17 novembre 2026.](https://quelleia.com/guides/openai-api/une-requete-responses.svg)

*Le trajet d'une requête à l'API Responses, des paramètres envoyés à la facture, d'après la documentation développeur d'OpenAI lue le 17 novembre 2026.*

## Créer une clé et faire une première requête

1. Créez un compte sur platform.openai.com, ajoutez un moyen de paiement, puis créez une clé dans la page **API keys** (platform.openai.com/api-keys).
2. Rangez la clé dans une variable d'environnement :

```bash
# macOS et Linux
export OPENAI_API_KEY="votre_cle"
```

```powershell
# Windows
setx OPENAI_API_KEY "votre_cle"
```

3. Installez le SDK de votre langage (`pip install openai` pour Python, `npm install openai` pour JavaScript). Il lit la clé dans la variable tout seul.
4. Lancez une première requête à l'API Responses :

```python
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6.2-sol",
    input="Écris en une phrase une histoire pour endormir un enfant, avec une licorne.",
)

print(response.output_text)
```

La même requête sans SDK, avec curl :

```bash
curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model": "gpt-6.2-sol", "input": "Bonjour, qui es-tu ?"}'
```

![Page Developer quickstart de la documentation OpenAI : Create and export an API key, avec les commandes export OPENAI_API_KEY pour macOS et Linux et setx pour Windows.](https://quelleia.com/guides/openai-api/demarrage-api.webp)

*Le démarrage rapide de l'API, le 17 novembre 2026 : créer une clé, l'exporter dans une variable d'environnement, installer le SDK (capture developers.openai.com).*

## L'API Responses

L'API Responses est le point d'entrée recommandé par OpenAI ; les SDK officiels et les nouveaux modèles y sont pensés. L'ancienne API Chat Completions répond encore pour GPT-6.2 Astra et Sol, mais l'appel d'outils exige Responses. Quatre champs suffisent pour la plupart des usages :

- `model` : l'identifiant du modèle, par exemple `gpt-6.2-astra` ;
- `input` : le texte, ou une liste de messages qui peut contenir des images ;
- `reasoning` : l'effort de réflexion (`{"effort": "medium"}`) ;
- `tools` : les outils que le modèle peut appeler.

Pour GPT-6.2, la documentation donne ces consignes de migration :

- commencez avec un effort `medium` ; si vous utilisiez `none` ou `minimal`, passez à `low`, car l'API refuse `none` pour ces modèles ;
- retirez `temperature`, `top_p` et `top_logprobs`, que GPT-6.2 n'accepte pas ;
- pour la mise en cache, remplacez `prompt_cache_retention` par `prompt_cache_options.ttl` réglé sur `"30m"` ;
- ne modifiez pas le début d'une conversation en cours : à partir de GPT-6.2, l'API abandonne les éléments de raisonnement quand l'historique change, ce qui peut faire baisser la qualité. Pour changer d'effort ou de format entre deux réponses, ajoutez un élément `configuration_update` avant le message suivant.

```python
response = client.responses.create(
    model="gpt-6.2-astra",
    reasoning={"effort": "high"},
    input="Compare ces trois architectures et recommande-en une, avec ses risques.",
)
```

## Les modèles

![Page Models de la documentation de l'API OpenAI, avec la phrase qui conseille GPT-6.2 Astra pour commencer et la liste Featured models.](https://quelleia.com/guides/openai-api/catalogue-modeles.webp)

*Le catalogue des modèles de l'API, le 17 novembre 2026 : GPT-6.2 Astra, GPT-6.2 Sol, GPT-6.1 Terra et GPT-6 Luna en tête (capture developers.openai.com).*

| Modèle | Usage selon OpenAI | Contexte | Connaissances jusqu'au |
| --- | --- | --- | --- |
| `gpt-6.2-astra` | les projets les plus difficiles, de bout en bout | 1 050 000 jetons (922 000 en entrée, 128 000 en sortie) | 18 mai 2026 |
| `gpt-6.2-sol` | le travail courant, du code aux agents à grande échelle | 1 050 000 jetons (922 000 en entrée, 128 000 en sortie) | 1er juin 2026 |
| `gpt-6.1-terra` | lecture d'images, commande d'un ordinateur, écriture claire | voir sa fiche | voir sa fiche |
| `gpt-6-luna` | tâches ciblées en grand volume | voir sa fiche | voir sa fiche |

Tous acceptent du texte et des images en entrée et rendent du texte. Le catalogue garde aussi les anciens modèles (GPT-5.x, GPT-6 Astra et Sol), des modèles d'images (GPT-Image-2.6 Sunburst et Flare), de voix (GPT-Realtime, GPT-Live, GPT-Transcribe), d'intégration de texte (text-embedding-3) et les modèles à poids ouverts gpt-oss. Les modèles vidéo Sora 2 ont fermé le 24 septembre 2026.

Comment se placent les modèles d'OpenAI face aux autres pour le code ? Notre classement, recalculé chaque lundi :

**Le haut du classement Code**

1. [Claude Opus 5.5](https://quelleia.com/modeles/claude-opus-5-5/) : 101,4 (Anthropic)
2. [Gemini 4 Carbon](https://quelleia.com/modeles/gemini-4-carbon/) : 100,6 (Google DeepMind)
3. [Claude Fable 5.1](https://quelleia.com/modeles/claude-fable-5-1/) : 100,1 (Anthropic)
4. [Claude Sonnet 5.5](https://quelleia.com/modeles/claude-sonnet-5-5/) : 99,8 (Anthropic)
5. [GPT-6 Astra](https://quelleia.com/modeles/gpt-6-astra/) : 99,3 (OpenAI)

Score Code, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.
[Classement Code des modèles de langage](https://quelleia.com/classement/code/)

## Les outils

Le champ `tools` donne au modèle des capacités qu'il décide d'utiliser seul (ou que vous imposez avec `tool_choice`) :

- **hébergés par OpenAI** : recherche web (`web_search`), recherche dans des fichiers envoyés, shell dans un conteneur, Code Interpreter, commande d'un ordinateur, génération d'images, skills, serveurs MCP distants ;
- **les vôtres** : des fonctions (function calling) que votre programme exécute avant de renvoyer le résultat au modèle ;
- **pour les gros catalogues** : la recherche d'outils, qui ne charge les définitions qu'au besoin, et l'appel d'outils programmé, où le modèle écrit un petit programme JavaScript qui enchaîne les appels.

```python
response = client.responses.create(
    model="gpt-6.2-sol",
    tools=[{"type": "web_search"}],
    input="Quelle bonne nouvelle a fait l'actualité aujourd'hui ? Donne la source.",
)
print(response.output_text)
```

Pour une boucle d'agent complète (appels d'outils successifs, bac à sable), OpenAI propose l'API Agents et le SDK Agents, qui gèrent la boucle à votre place.

## Les prix

Les prix sont en dollars par million de jetons, en mode Standard, pour une requête de moins de 272 000 jetons en entrée (relevé du 17 novembre 2026) :

| Modèle | Entrée | Entrée en cache | Sortie |
| --- | --- | --- | --- |
| `gpt-6.2-astra` | 8 $ | 0,40 $ | 40 $ |
| `gpt-6.2-sol` | 2 $ | 0,10 $ | 10 $ |
| `gpt-6.1-terra` | 1 $ | 0,05 $ | 5 $ |
| `gpt-6-luna` | 0,10 $ | 0,01 $ | 0,50 $ |

![Page Pricing de l'API OpenAI, onglets Standard, Batch, Flex, Fast, Ultrafast, et un tableau avec gpt-6.2-astra à 8 dollars en entrée et 40 en sortie, gpt-6.2-sol à 2 et 10, gpt-6-astra et gpt-6.1-sol.](https://quelleia.com/guides/openai-api/tarifs-api.webp)

*La grille des prix de l'API en mode Standard, contexte court, le 17 novembre 2026, en dollars par million de jetons (capture developers.openai.com).*

Ce qui fait varier la facture :

- **Le contexte long.** Au-delà de 272 000 jetons en entrée, l'entrée et le cache coûtent le double et la sortie 1,5 fois plus, pour toute la requête.
- **Le mode de traitement.** Batch coûte la moitié du Standard (réponse différée). Fast coûte le double. Ultrafast coûte trois fois le Standard jusqu'au 28 février 2027, puis six fois à partir du 1er mars 2027, pour GPT-6.2 Astra et Sol. Certaines requêtes en arrière-plan bénéficient de remises.
- **L'écriture en cache.** Garder un préfixe en cache 30 minutes coûte 10 $ par million de jetons pour Astra (2,50 $ pour Sol), 12 heures le double.
- **Les outils.** La recherche web coûte 10 $ les 1 000 appels, auxquels s'ajoutent les jetons des résultats ; la recherche dans des fichiers 2,50 $ les 1 000 appels et 0,10 $ par Go et par jour de stockage (1 Go offert) ; un conteneur de 1 Go 0,03 $ par session de 20 minutes.
- **La région.** Le traitement des données dans une région choisie (Europe comprise) coûte 10 % de plus pour les modèles sortis à partir du 5 mars 2026.

Le guide [Jetons et prix](https://quelleia.com/guides/jetons-et-prix/) montre comment estimer le coût d'une tâche à partir de ces tarifs.

## Vos données

![Page Data controls in the OpenAI platform : Your data is your data, puis les types de données conservées, journaux de surveillance des abus et état des applications.](https://quelleia.com/guides/openai-api/donnees-api.webp)

*La page « Data controls in the OpenAI platform », le 17 novembre 2026 : les données envoyées à l'API ne servent pas à l'entraînement, sauf accord explicite (capture developers.openai.com).*

Depuis le 1er mars 2023, les données envoyées à l'API ne servent pas à entraîner les modèles d'OpenAI, sauf si vous l'acceptez explicitement. Elles peuvent être gardées jusqu'à 30 jours dans des journaux de surveillance des abus. Les organisations approuvées peuvent obtenir la conservation zéro (Zero Data Retention) ou une surveillance modifiée, qui excluent leurs contenus de ces journaux ; le réglage se fait ensuite dans **Settings > Organization > Data controls > Data retention**. GPT-6.2 Astra et Sol prennent en charge la conservation zéro et le traitement des données aux États-Unis ou en Europe en Standard, Fast et Batch ; Ultrafast reste réservé aux États-Unis.

## Précautions

- **Une clé est un moyen de paiement.** Ne la mettez ni dans le code, ni dans un dépôt Git, ni dans une appli distribuée : un serveur à vous doit faire l'appel.
- **Testez sur un petit échantillon** avant de lancer un script en boucle, et surveillez la consommation dans le tableau de bord de la plateforme.
- **Les identifiants changent.** OpenAI retire des modèles à date fixe (la page Deprecations les liste) : écrivez l'identifiant à un seul endroit de votre code.
- **Un outil de recherche web ou un serveur MCP rapporte du contenu non fiable** ; ne laissez pas le modèle agir sur ce contenu sans contrôle.

## Pour aller plus loin

- [Openai](https://quelleia.com/editeurs/openai/)
- [Gpt 6 2 astra](https://quelleia.com/modeles/gpt-6-2-astra/)
- [Gpt 6 2 sol](https://quelleia.com/modeles/gpt-6-2-sol/)
- [Gpt 6 1 terra](https://quelleia.com/modeles/gpt-6-1-terra/)
- [Gpt 6 luna](https://quelleia.com/modeles/gpt-6-luna/)
- [Classement Code des modèles de langage](https://quelleia.com/classement/code/)
- [Codex](https://quelleia.com/outils/codex/)
- [Jetons, prix au million et vrai coût d'une tâche](https://quelleia.com/guides/jetons-et-prix.md) (guide, amateur)
- [Quel effort de réflexion choisir pour une IA, et quand](https://quelleia.com/guides/quel-effort-choisir.md) (guide, amateur)
- [MCP : brancher des outils dans Claude, ChatGPT ou un agent](https://quelleia.com/guides/mcp.md) (guide, amateur)
- [Configurer Codex : config.toml, effort, bac à sable, approbations](https://quelleia.com/guides/codex-configuration.md) (guide, expert)

## Sources

- https://developers.openai.com/api/docs/quickstart (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/models (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/models/gpt-6.2-astra (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/models/gpt-6.2-sol (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/guides/latest-model (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/pricing (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/guides/tools (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/guides/migrate-to-responses (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/guides/your-data (lue le 17 novembre 2026)
- https://developers.openai.com/api/docs/deprecations (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/whats-new/gpt-62-astra-sol (lue le 17 novembre 2026)
