Erreur 403 : que faire quand hy3 échoue

Un 403 signifie que vous êtes authentifié mais non autorisé : la clé est valide, mais elle ne peut pas appeler ce modèle ni ce groupe.

403 Forbidden signifie que l’identité a été reconnue mais que l’accès est refusé. La différence avec 401 : 401 demande qui vous êtes, 403 dit que vous n’avez pas la permission. Il faut généralement ajouter le modèle à la liste autorisée ou au groupe lié à votre clé.

hy3 est fourni par Tencent. 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 : Cette clé n'est pas autorisée pour ce modèle. La première action recommandée : Ajoutez ce modèle à la liste autorisée de la clé sur la page Jetons.

Causes fréquentes

  • Cette clé n'est pas autorisée pour ce modèle
  • Le modèle n'est pas dans le groupe auquel la clé est liée
  • La clé possède une liste d'IP autorisées qui exclut votre IP actuelle
  • Le modèle a été retiré ou exige des droits supérieurs

Comment corriger

  • Ajoutez ce modèle à la liste autorisée de la clé sur la page Jetons
  • Vérifiez que le groupe de la clé inclut ce modèle
  • Contrôlez les paramètres de liste d'IP autorisées
  • Passez à un modèle que vous êtes autorisé à appeler

Nouvelle tentative avec backoff exponentiel

Le code ci-dessous réessaie lorsque hy3 renvoie 403 : 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 = 'hy3'


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
FournisseurTencent
Contexte256K
CapacitésReasoning, Tools, Open Weights
Formats d’APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Formule de facturationp * 0 + cr * 0 + cc * 0 + c * 0

Questions fréquentes

403 sur hy3 est-il lié à mon quota de compte ?

Relever le plafond de la formule ou baisser la fréquence des appels : les deux aident. La facturation suit p * 0 + cr * 0 + cc * 0 + c * 0 : sans sortie, aucun débit. Avec la facturation p * 0 + cr * 0 + cc * 0 + c * 0, les requêtes échouées ne sont pas comptées dans l’usage. 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 + cr * 0 + cc * 0 + c * 0, incluez aussi le budget de relances.

Faut-il basculer sur un modèle de secours quand 403 apparaît ?

Gardez aussi un modèle de repli prêt. Ce modèle de Tencent 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.

Les retry doivent-ils ajouter du jitter aléatoire ?

Il n’est généralement pas nécessaire de modifier le code, seulement le rythme des appels. Réessayer est la première étape la plus efficace. Avec la facturation p * 0 + cr * 0 + cc * 0 + c * 0, les requêtes échouées ne sont pas comptées dans l’usage. Fixez la limite de relances à 3–5 et ajoutez du jitter.

Faut-il modifier les paramètres quand hy3 renvoie 403 ?

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 256K 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 403.

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 13:20

Support techniqueAssistance en ligne
Haut de page