Erreurs et limites de débit

Les erreurs reviennent sous forme de JSON au format d'erreur OpenAI. Le message indique ce qui s'est passé, code est un identifiant stable lisible par machine, et un id de requête est ajouté à chaque message :

{
  "error": {
    "message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

Incluez toujours l'id de requête lorsque vous contactez le support ou ouvrez un ticket Discord. Il nous permet de retrouver votre requête exacte dans les journaux.

Les codes de statut que vous rencontrerez réellement :

Deux situations très différentes partagent le statut 503. La première est une congestion temporaire :

HTTP/1.1 503 Service Unavailable

{
  "error": {
    "message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Le code get_channel_failed (tous les fournisseurs occupés) signifie que tous les fournisseurs gratuits de ce modèle sont momentanément limités en débit. Cela se rétablit tout seul en quelques minutes : réessayez ou changez de modèle. Le code model_not_found (non proposé ici) signifie que le nom du modèle lui-même ne se résout pas, et réessayer n'aidera jamais. Vérifiez les fautes de frappe ou recherchez le nom actuel dans le catalogue.

Traitez le 503 avec get_channel_failed comme une nouvelle tentative ou un repli, et le 503 avec model_not_found comme une erreur bloquante dans votre client.

Un 429 peut provenir de plusieurs couches :

• Notre plafond de modèles gratuits : 1 requête par minute par modèle gratuit par utilisateur. Un plafond d'équité pour que les pools partagés survivent aux heures de pointe.
• Limites du fournisseur upstream : le fournisseur derrière un modèle gratuit a atteint son propre plafond ("temporarily rate-limited upstream", c'est-à-dire temporairement limité en amont).
• Budgets quotidiens de jetons sur certains pools gratuits ; ils se réinitialisent à minuit UTC.
• Plafonds de jetons par minute qui se déclenchent sur de très gros prompts.
• Une limite de concurrence par utilisateur lorsque trop de requêtes s'exécutent en parallèle.

Les modèles payants n'ont aucune limite de débit imposée par UnoRouter.

Lorsque notre plafond de 1 par minute se déclenche, vous obtenez des en-têtes standard de limite de débit, pour que les clients puissent temporiser avec précision :

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

Retry-After est dynamique : les secondes réellement restantes dans votre fenêtre, et non un 60 fixe. Le message d'erreur nomme aussi le jumeau payant du modèle, qui n'a aucune limite.

Certains modèles habituellement payants sont proposés gratuitement avec un plafond de taille de requête. Les prompts trop volumineux reçoivent un 413 avec un message comme : Request body too large for gpt-4.1 model. Max size: 8000 tokens.

Le plafond ne s'applique qu'à la route d'essai gratuit ; le modèle payant accepte les prompts de pleine longueur.

Respectez Retry-After sur les 429. Réessayez le 503 get_channel_failed après une courte attente, ou repliez-vous sur un autre modèle. Ne réessayez pas les erreurs de classe 400, elles sont déterministes.

Les requêtes échouées et refusées ne sont pas facturées : toute préautorisation sur votre solde est remboursée lorsque la requête échoue.