Erreur 401 : que faire quand gpt-5-nano échoue

Un 401 signifie que l'authentification a échoué : la requête ne porte pas de clé API, ou la clé est invalide, supprimée ou expirée.

401 Unauthorized signifie que la requête ne porte aucun identifiant valide. La passerelle n’a pas pu identifier l’appelant, donc la requête n’atteint jamais le modèle upstream. Vérifier l’en-tête Authorization et l’état de la clé est la seule voie.

gpt-5-nano est fourni par OpenAI. Tout sur cette page — causes, correctifs et données mesurées — est établi à partir du comportement réel de ce modèle au niveau de la passerelle.

Sur cette passerelle, le déclencheur le plus courant est : L'en-tête Authorization est absent. La première action recommandée : Envoyez l'en-tête sous la forme Authorization: Bearer suivi de votre clé.

Causes fréquentes

  • L'en-tête Authorization est absent
  • La clé est mal orthographiée ou contient des espaces superflus
  • La clé a été supprimée ou désactivée sur la page Jetons
  • Une clé d'une autre plateforme a été utilisée par erreur

Comment corriger

  • Envoyez l'en-tête sous la forme Authorization: Bearer suivi de votre clé
  • Générez une nouvelle clé sur la page Jetons
  • Vérifiez que vous n'utilisez pas la clé d'un autre service
  • Validez la clé avec une requête curl minimale

Nouvelle tentative avec backoff exponentiel

Le code ci-dessous réessaie lorsque gpt-5-nano renvoie 401 : jusqu’à 5 tentatives, avec une attente croissante et un jitter aléatoire pour éviter que les appels concurrents ne réessaient simultanément. Lisez l’URL de base et la clé API depuis les variables d’environnement, ne les écrivez jamais en dur.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gpt-5-nano'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Données clés de ce modèle

Point de terminaison APIhttps://api.airai.cc/v1
Compatible OpenAIOpenAI-compatible
FournisseurOpenAI
Contexte400K
CapacitésReasoning, Tools, Files, Vision
Formats d’APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Formule de facturationp * 0.05 + cr * 0.005 + c * 0.4

Questions fréquentes

Que consigner quand 401 se produit souvent ?

Conservez l’identifiant de requête et le corps brut de la réponse, sinon rien ne peut être retracé. Ce modèle est servi par OpenAI, l’état en amont dépend donc des annonces du fournisseur. Reproduisez d’abord le cas en préproduction avec le même corps de requête.

401 est-il lié à la facturation de gpt-5-nano ?

Aucune facturation : seule la sortie réellement produite compte dans l’usage. Seule la sortie déjà produite est facturée, pas la partie échouée. Le prix d’entrée est d’environ $0.05 par million de tokens. Vérifiez d’abord le solde et les limites de débit dans la console, ensuite le code. En estimant le coût à partir de p * 0.05 + cr * 0.005 + c * 0.4, incluez aussi le budget de relances.

401 affecte-t-il d’autres modèles du même compte ?

Cette erreur ne dépend pas de la capacité du modèle, elle est au niveau de la passerelle. C’est généralement passager et se rétablit tout seul. Les balises de capacité de ce modèle sont Reasoning, Tools, Files, Vision. Si l’erreur persiste plusieurs minutes, contactez le support de la plateforme pour confirmer l’état en amont. Déterminez d’abord si c’est au niveau du compte ou du modèle ; les deux demandent un traitement totalement différent.

Faut-il modifier les paramètres quand gpt-5-nano renvoie 401 ?

Les paramètres doivent changer ; réessayer seul ne suffira pas. C’est un problème de configuration côté client ; rien ne change côté serveur. La fenêtre de contexte 400K fixe l’entrée maximale par requête ; au-delà, c’est rejeté immédiatement. Échouez rapidement sur les erreurs de paramètres au lieu d’y dépenser des relances. Tronquez ou résumez les entrées longues : cela réduit nettement 401.

Autres erreurs sur ce modèle

Autres modèles avec la même erreur

Retour à la page du modèle

Données mises à jour: 2026-10-11 19:15

Support techniqueAssistance en ligne
Haut de page