Guide de l'API GPT-5.5 : modèle, clé et maîtrise des coûts (2026)

GPT-5.5 est un modèle de pointe publié par OpenAI le 23 avril 2026, destiné aux tâches professionnelles complexes, au raisonnement en plusieurs étapes et aux workflows d'agents, avec une fenêtre de contexte de 1,05 million de jetons. Après la sortie de la série GPT-5.6 en juillet 2026, GPT-5.5 n'a pas perdu sa valeur : les équipes qui disposent déjà de bases d'évaluation, de prompts et de chaînes de production ont souvent besoin de sa stabilité, et les tâches de raisonnement vraiment difficiles méritent encore un modèle de gamme supérieure.

Mais la facture GPT-5.5 dérape aussi plus facilement. La cause n'est pas le prix unitaire, mais le supplément de contexte long, les différences de cache, les nouvelles tentatives et les sorties inutiles qui s'additionnent. Cet article suit l'ordre « spécifications — obtention de clé — appels — maîtrise des coûts — diagnostic des erreurs » pour fournir un guide d'intégration directement applicable.

Remarque : OpenAI, GPT et ChatGPT sont des marques de leurs détenteurs respectifs ; cet article est purement technique. Les spécifications, longueurs de contexte et règles de facturation sont celles de la documentation officielle OpenAI et de la page Tarifs des modèles ; nous ne figeons aucun prix unitaire.

1. Spécifications et positionnement

L'identifiant de GPT-5.5 est gpt-5.5, avec un instantané par défaut gpt-5.5-2026-04-23. Il accepte du texte et des images en entrée et renvoie du texte, ce qui convient aux tâches exigeant un raisonnement solide et l'appel d'outils.

Élément	Information officielle
Identifiant	`gpt-5.5`
Instantané par défaut	`gpt-5.5-2026-04-23`
Fenêtre de contexte	1 050 000 jetons
Sortie maximale	128 000 jetons
Entrée/sortie	Texte, images → texte
Fin de connaissances	1er décembre 2025
Intensité de raisonnement	none, low, medium, high, xhigh ; medium par défaut
Interfaces principales	Chat Completions, Responses, Batch

Une limite à vérifier absolument : GPT-5.5 ne prend pas en charge le fine-tuning, les embeddings, Realtime, la transcription audio ni la génération d'images. C'est un modèle de conversation et de raisonnement, pas une entrée universelle ; pour la vectorisation ou la voix, choisissez un modèle spécialisé.

En termes de positionnement, GPT-5.5 convient à :

l'analyse en plusieurs étapes de contrats, rapports financiers et études complexes ;
la revue de code difficile, les plans de refactorisation et le diagnostic de pannes ;
les agents nécessitant des appels d'outils et une planification multi-tours ;
les tâches hors ligne à haute exigence de qualité, où un coût plus élevé est acceptable.

Pour de la classification, de l'extraction, du résumé ou de la réécriture, évaluez d'abord GPT-5.6 Terra ou un modèle plus léger, généralement plus rentable.

2. GPT-5.5 ou GPT-5.6 Terra

C'est la question de choix la plus fréquente au second semestre 2026. Les deux ont la même fenêtre de contexte, mais un positionnement et une date de fin de connaissances différents.

Dimension	GPT-5.5	GPT-5.6 Terra
Date de sortie	Avril 2026	Juillet 2026
Positionnement	Tâches complexes de pointe	Production quotidienne équilibrée
Contexte	1 050 000 jetons	1 050 000 jetons
Fin de connaissances	Décembre 2025	Février 2026
Niveau de prix	Plus élevé	Plus bas, selon la page de tarifs
Scénarios	Problèmes difficiles, agents complexes, bases d'évaluation existantes	Volume, sensibilité au coût, tâches courantes

Ne choisissez pas seulement « le plus récent ». La bonne méthode consiste à préparer 50 à 100 tâches réelles, à les stratifier par type, puis à exécuter GPT-5.5 et Terra en comparant précision, jetons moyens, latence et taux d'échec. Si l'écart de Terra sur les indicateurs métier est faible, basculez la majorité du trafic et ne réservez GPT-5.5 qu'aux requêtes vraiment difficiles.

3. Deux voies pour obtenir une clé API

Voie 1 : connexion directe à la plateforme OpenAI

Inscrivez-vous et connectez-vous à la plateforme développeur OpenAI, puis configurez l'organisation, le projet et la facturation.
Créez une clé depuis la page API Keys, nommée selon le projet ou l'environnement.
Vérifiez le solde du projet, les limites de débit et les permissions du modèle gpt-5.5.
Stockez la clé dans une variable d'environnement serveur ou un coffre-fort de secrets ; ne la commitez jamais dans Git.

L'URL de base directe est https://api.openai.com/v1. Cette voie convient aux équipes disposant d'un paiement à l'étranger, voulant un titulaire de facturation clair et n'utilisant que les modèles OpenAI.

Voie 2 : ZSQH AI Gateway

Créez un compte sur ZSQH AI Gateway, générez une clé, rechargez en yuan et gérez dans une seule console l'usage et la facturation de plusieurs modèles. La passerelle fournit une entrée compatible OpenAI, avec l'URL de base https://ai.zhongshangqihang.com/v1 ; un SDK OpenAI existant ne demande généralement que la modification de base_url, api_key et model.

Cette voie convient aux équipes qui paient localement, ont besoin de factures en yuan et appellent plusieurs fournisseurs. L'activation des modèles et le nom exact à utiliser sont indiqués sur la page Tarifs des modèles.

4. URL de base et choix de l'interface

Élément	Connexion directe OpenAI	Passerelle ZSQH
URL de base	`https://api.openai.com/v1`	`https://ai.zhongshangqihang.com/v1`
Clé API	Créée sur la plateforme OpenAI	Créée dans la console de la passerelle
Nom du modèle	`gpt-5.5`	Selon la page de tarifs du site
SDK	SDK OpenAI	SDK OpenAI
Facturation	Selon les règles de la plateforme	Facture en yuan, selon la politique de la plateforme

Côté interface, Chat Completions offre la meilleure compatibilité et le coût de migration le plus faible pour du code existant ; l'interface Responses prend mieux en charge les appels d'outils, la gestion d'état et les tâches multi-tours, et mérite une évaluation prioritaire pour un nouveau projet. Les deux sont prises en charge ; l'essentiel est de ne pas mélanger les deux formats de requête dans la même couche d'abstraction.

5. Appel en curl

export ZSQH_API_KEY="sk-votre-clé"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "Vous êtes un réviseur de code senior : listez d’abord les risques, puis les recommandations."},
      {"role": "user", "content": "Vérifiez l’idempotence de ce code de callback de paiement."}
    ],
    "reasoning_effort": "medium",
    "max_tokens": 1200
  }'

Si la passerelle ne reconnaît pas reasoning_effort, retirez d'abord ce paramètre, validez la requête minimale avec l'intensité par défaut, puis rajoutez-le progressivement selon la documentation du site. Ne modifiez pas simultanément le nom du modèle, l'URL de base et les paramètres, sinon l'erreur devient impossible à attribuer.

6. Appel en Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "system", "content": "Vous êtes un assistant d’analyse financière : donnez la conclusion et les justificatifs."},
        {"role": "user", "content": "Comparez l’évolution de la structure de revenus des deux rapports trimestriels."},
    ],
    reasoning_effort="medium",
    max_tokens=1500,
)

print(resp.choices[0].message.content)

En production, ajoutez trois protections : délai d'attente, nouvelles tentatives avec délai exponentiel et journalisation d'usage par ligne d'activité. Les tentatives ne valent que pour 429, 5xx et erreurs réseau ; réessayer une erreur 400 ne fait qu'alourdir la facture.

7. Maîtrise des coûts : commencer par le contexte long

La règle de facturation la plus souvent négligée de GPT-5.5 est la suivante : lorsque l'entrée d'une requête dépasse 272K jetons, toute la requête est facturée avec un multiplicateur de 2 sur l'entrée et de 1,5 sur la sortie. Il s'agit de « toute la requête », pas seulement de la partie excédentaire ; la règle s'applique aussi aux requêtes standard, Batch et Flex.

Scénario	Risque principal	Pratique recommandée
Contrat ou dépôt de code entier envoyé tel quel	Dépassement de 272K, multiplicateur sur toute la requête	Récupérer les chapitres utiles ou découper par frontière métier
Prompt système et définitions d'outils répétés	Frais d'entrée répétés à chaque appel	Utiliser le cache de préfixe et garder un préfixe stable
Rapports et code longs en sortie	Coût de sortie élevé	Définir `max_tokens` et exiger une sortie structurée
Modèle haut de gamme pour une simple classification	Prix unitaire inadapté	Router vers Terra ou un modèle léger
Renvoi immédiat après un 429	Requêtes et facturation en double	Délai exponentiel et nombre maximal de tentatives
Absence de journal d'usage	Impossible de localiser une anomalie	Consigner identifiant, jetons, cache et durée

Pour réduire encore, appliquez cet ordre :

Comprimer l'entrée sous 272K par recherche ou résumé, pour éviter le multiplicateur global.
Placer prompt système, définitions d'outils et base de connaissances fixe au début et activer le cache.
Ne mettre en cache que ce qui sera réellement réutilisé ; un document à usage unique ne doit pas être mis en cache.
Router selon la difficulté : tâche simple vers une gamme légère, tâche courante vers Terra, problème difficile vers GPT-5.5.
Utiliser l'interface Batch pour les tâches hors ligne, généralement avec une remise dédiée.
Fixer plafonds et alertes par clé pour arrêter rapidement les appels anormaux.
Revoir chaque semaine le classement des consommations et optimiser d'abord la ligne d'activité dominante.

Pour estimer, utilisez la formule ci-dessous ; prix et multiplicateurs sont ceux de la page Tarifs des modèles :

Coût estimé =
  jetons d'entrée × prix d'entrée × multiplicateur de contexte long
+ jetons lus dans le cache × prix de lecture du cache
+ jetons de sortie × prix de sortie × multiplicateur de contexte long

Multiplicateur de contexte long : entrée 1 ou 2, sortie 1 ou 1,5

8. Erreurs courantes

Erreur	Cause fréquente	Traitement
`401 Unauthorized`	Clé erronée, Bearer absent, clé supprimée	Recopier la clé, vérifier l'en-tête
`404 Not Found`	`/v1` en trop ou manquant dans l'URL de base	Écrire l'adresse selon la documentation
`model not found`	Nom de modèle incorrect ou non activé	Copier le nom depuis la page de tarifs
`400 Bad Request`	Paramètre non pris en charge ou JSON invalide	Retirer le paramètre suspect, vérifier le corps
`429 Too Many Requests`	Concurrence ou fréquence dépassée	Réduire la concurrence, délai exponentiel
`context_length_exceeded`	Entrée au-delà de la fenêtre	Découper, rechercher ou résumer
`insufficient_quota`	Solde insuffisant ou quota épuisé	Recharger ou changer de clé

Questions fréquentes

GPT-5.5 ou GPT-5.6 Terra : lequel est le plus puissant ?

Impossible de généraliser. GPT-5.5 vise les tâches complexes de pointe, GPT-5.6 Terra la production quotidienne équilibrée, avec une fin de connaissances plus récente et un niveau de prix inférieur. Un jeu d'évaluation métier réel comparant précision, consommation de jetons et latence est plus fiable qu'un tableau de caractéristiques.

272K est-il la limite de contexte ?

Non. La fenêtre de GPT-5.5 est de 1 050 000 jetons ; 272K est le seuil de déclenchement de la facturation de contexte long. Au-delà, l'appel reste possible, mais toute la requête est facturée au multiplicateur supérieur.

GPT-5.5 prend-il en charge le fine-tuning ?

Non. La page officielle classe le fine-tuning, les embeddings, Realtime, l'audio et la génération d'images parmi les capacités non prises en charge. Il faut alors choisir un modèle ou une interface spécialisée.

La clé API GPT-5.5 fonctionne-t-elle avec l'abonnement ChatGPT ?

Non. L'abonnement concerne le produit ChatGPT ; la clé API est un identifiant développeur, avec une facturation et des permissions séparées.

Comment estimer le coût mensuel ?

Mesurez d'abord la distribution réelle des jetons d'entrée, de sortie et de cache sur le trafic réel, multipliez par les prix et le multiplicateur de contexte long, puis ajoutez la perte due aux tentatives et aux échecs. N'estimez pas à partir d'un « coût moyen par appel » : l'erreur serait importante.

Et ensuite

Commencez par créer un compte ZSQH AI Gateway, générez une clé de test, validez une requête minimale en curl, puis répartissez clés et budgets par ligne d'activité. Les noms de modèles, contextes et prix sont indiqués sur la page Tarifs des modèles.