Erreur 502 : que faire quand gemini-3.5-flash échoue

Un 502 signifie que la passerelle a reçu une réponse invalide du service de modèle amont : la requête a atteint la passerelle, mais le saut vers l'amont a échoué.

502 Bad Gateway signifie que la passerelle a reçu une réponse invalide du service upstream du modèle. La requête a atteint la passerelle ; l’échec s’est produit sur le saut vers l’upstream, généralement à cause d’un redémarrage de nœud ou d’une connexion coupée.

gemini-3.5-flash est fourni par Google. 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 : Le service de modèle amont est indisponible ou a renvoyé une réponse mal formée. La première action recommandée : Réessayez une fois : les 502 sont généralement passagères.

Causes fréquentes

  • Le service de modèle amont est indisponible ou a renvoyé une réponse mal formée
  • Un nœud amont redémarre
  • La connexion entre la passerelle et l'amont a été interrompue
  • Le modèle a été temporairement retiré

Comment corriger

  • Réessayez une fois : les 502 sont généralement passagères
  • Passez à un modèle équivalent d'un autre fournisseur
  • Si un seul modèle renvoie 502, son amont est en panne
  • Réessayez plus tard ou contactez-nous

Nouvelle tentative avec backoff exponentiel

Le code ci-dessous réessaie lorsque gemini-3.5-flash renvoie 502 : 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 = 'gemini-3.5-flash'


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

TPS1669.89
Latence moyenne3330 ms
Taux de réussite100%
Point de terminaison APIhttps://api.airai.cc/v1
Compatible OpenAIOpenAI-compatible
FournisseurGoogle
Contexte1M
CapacitésReasoning, Tools, Files, Vision, Audio
Formats d’APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Formule de facturationp * 1.5 + cr * 0.15 + ai * 1.5 + c * 9

Questions fréquentes

Un modèle équivalent d’un autre fournisseur corrige-t-il 502 ?

Gardez aussi un modèle de repli prêt. Un repli intégré à l’architecture est plus fiable que de corriger chaque erreur séparément. Ce modèle de Google dispose de plusieurs nœuds upstream entre lesquels la passerelle peut basculer. Mettez le nom du modèle en configuration : changer d’amont ne demande alors aucune modification de code.

Faut-il modifier les paramètres quand gemini-3.5-flash renvoie 502 ?

Les paramètres doivent changer ; réessayer seul ne suffira pas. La fenêtre de contexte 1M 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 502.

502 affecte-t-il les requêtes déjà envoyées à gemini-3.5-flash ?

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, Audio. Déterminez d’abord si c’est au niveau du compte ou du modèle ; les deux demandent un traitement totalement différent.

Quelles informations donner au support lors d’un signalement ?

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 Google, l’état en amont dépend donc des annonces du fournisseur. Enregistrez l’identifiant de requête à chaque échec : c’est plus utile que le code d’état.

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-10 15:45

Support techniqueAssistance en ligne
Haut de page