---
title: "Codes d’erreur API LLM 401, 402, 409, 429 : réessayer ?"
description: "Ce que signifie chaque statut HTTP de l’API BroadNet Inference, lesquels réessayer avec backoff, lesquels corriger d’abord, et quoi envoyer au support avec un ID."
url: https://broadrouter.com/fr/guides/errors-and-retries/
lang: fr
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/errors-and-retries/) (mis à jour le 2026-11-14).

# Codes d’erreur de BroadNet Inference : quand réessayer ?

Mis à jour 2026-11-14

Vérifiez le statut HTTP avant d’analyser le corps. Réessayez les 429 et 5xx avec un backoff exponentiel borné. Corrigez les 400, 403, 413 et 422 avant de réessayer. Pour un 401, vérifiez la clé et le solde ; pour un 402, alimentez le compte. Journalisez toujours l’en-tête X-Request-ID pour le support.

L’API renvoie un statut HTTP classique et un code d’erreur lisible par machine. Choisissez l’étape suivante d’après le statut. Ce tableau suit la [référence de l’API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-errors-and-retries&utm_content=body#errors) de BroadNet.

| Statut | Signification | Que faire |
| --- | --- | --- |
| 400 / 422 | Requête ou champ invalide | Corriger d’abord la requête |
| 401 | Clé absente, invalide ou expirée, budget à l’usage bloqué ou quota épuisé | Vérifier le statut de la clé et le solde du compte |
| 402 `insufficient_balance` | Le compte ne peut pas couvrir un achat ; le corps indique le solde et le prix | Alimenter le compte, puis réessayer |
| 403 | Refus par une politique de modèle, de route ou d’IP | Corriger l’incohérence, par exemple [une liste d’IP autorisées](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/) |
| 409 | Conflit avec l’état du compte : `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Ne réessayer que `mint_in_progress`, avec le même `request_id` |
| 413 | Requête trop volumineuse ; les fichiers de transcription sont plafonnés à 26 214 400 octets | Réduire la requête |
| 429 | Limite de débit, de concurrence, de tokens par minute ou de dépenses atteinte | Lire le détail de la réponse, patienter avec un backoff et réessayer |
| 500 / 502 / 503 / 504 | Traitement côté serveur | Réessayer avec un backoff exponentiel borné ; réutiliser le même `request_id` pour les achats de clés horaires |

La documentation de BroadNet indique de vérifier le statut HTTP avant d’analyser un corps JSON, puis de lire le code `error` lisible par machine s’il existe.

## Quelles limites provoquent un 429 ?

Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours simultanément. Selon la documentation de BroadNet, une clé horaire autorise 120 requêtes par minute, un flux et 300,000 tokens par minute. Avec un [forfait illimité](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/), chaque session traite une requête à la fois. Pour comparer ces limites avec celles d’OpenAI, Anthropic, Groq et DeepSeek, lisez [les limites de débit des API LLM par fournisseur](https://broadrouter.com/fr/blog/llm-api-rate-limits-by-provider/).

## Comment réessayer avec le SDK OpenAI ?

D’après son [README sur GitHub](https://github.com/openai/openai-python#retries), le SDK Python d’OpenAI réessaie déjà deux fois par défaut les erreurs de connexion et les réponses 408, 409, 429 et 5xx, avec un court backoff exponentiel. Son délai d’attente par défaut est de 10 minutes. Définissez les deux explicitement :

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_retries=4,   # 0 turns automatic retries off
    timeout=120,     # seconds; raise it for long reasoning answers
)
```

Les commentaires du code signifient : `max_retries=0` désactive les nouvelles tentatives automatiques, et le `timeout` (en secondes) est à augmenter pour les longues réponses de raisonnement.

## Comment écrire mon propre backoff ?

Si vous appelez l’API sans SDK, plafonnez à la fois le nombre d’essais et l’attente :

```python
import random, time, requests

RETRY = {429, 500, 502, 503, 504}

def post_with_backoff(url, headers, body, tries=5):
    for attempt in range(tries):
        r = requests.post(url, headers=headers, json=body, timeout=120)
        if r.status_code not in RETRY:
            return r                      # success, or an error to fix rather than retry
        time.sleep(min(30, 2 ** attempt) + random.random())
    return r
```

Ne réessayez jamais un 400, 403, 413 ou 422 sans rien changer : la même requête échoue de la même façon. Chaque nouvelle tentative d’une requête de chat est une nouvelle inférence, facturée à nouveau en paiement à l’usage. Le schéma général est décrit dans [backoff exponentiel](https://broadrouter.com/fr/glossary/exponential-backoff/).

## Réessayer sans risque l’achat d’une clé horaire

`POST /portal/keys/hourly` accepte un `request_id`. Après un délai dépassé, une connexion perdue, un 409 `mint_in_progress` ou un 5xx, réessayez avec le **même** `request_id`. Un `request_id` réutilisé ne crée ni ne facture jamais une deuxième clé ; la répétition renvoie `already_issued: true` et l’alias. Ne générez jamais un nouvel identifiant tant que vous ne connaissez pas le premier résultat. Plus de détails sur les [clés d’idempotence](https://broadrouter.com/fr/glossary/idempotency-key/).

## Dépannage

-   **401 juste après une recharge.** La page du compte de BroadNet affiche le dernier quota enregistré et indique qu’un changement de financement est en cours de mise à jour pendant son application. Actualisez la page et réessayez une fois l’opération terminée.
-   **429 avec seulement quelques requêtes par minute.** Vous atteignez probablement la limite de 4 requêtes simultanées, par exemple avec de longs flux en parallèle. Utilisez un petit pool de workers.
-   **403 sur un modèle mais pas sur un autre.** La politique de la clé ne couvre pas ce modèle ou cette route. Les clés de forfait, par exemple, sont prévues pour `broadnet/deepseek-v4.1-flash`, et une clé horaire ne couvre que `broadnet/gemma-4-26b-a4b`.
-   **Le SDK a réessayé et vous avez été facturé deux fois.** Une requête de chat réessayée est une nouvelle inférence. Définissez `max_retries=0` là où une réponse en double coûte plus cher qu’un échec.

## Quoi envoyer au support

Indiquez la valeur de l’en-tête `X-Request-ID`, l’horodatage UTC, la route, le statut HTTP et l’alias de votre clé. N’envoyez jamais la clé elle-même. Le [guide du SDK Python d’OpenAI](https://broadrouter.com/fr/guides/openai-python-sdk/) montre comment lire l’en-tête.

## Termes de ce guide

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[Token](https://broadrouter.com/fr/glossary/token/)

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

[Backoff exponentiel (exponential backoff)](https://broadrouter.com/fr/glossary/exponential-backoff/)

Le backoff exponentiel est une stratégie de nouvelle tentative dans laquelle un client attend plus longtemps après chaque échec, en doublant généralement le délai jusqu’à un plafond, avant de réessayer. Ajouter un jitter aléatoire à chaque attente étale les tentatives de nombreux clients, pour qu’elles ne frappent pas le serveur au même instant.

[Crédit prépayé (prepaid credit)](https://broadrouter.com/fr/glossary/prepaid-credit/)

Le crédit prépayé est de l’argent versé sur un compte API avant utilisation. Chaque requête déduit son coût du solde, et quand le solde est épuisé, les requêtes facturées s’arrêtent jusqu’à la prochaine recharge. Les dépenses sont ainsi plafonnées à ce que vous avez versé.

[Débit (throughput)](https://broadrouter.com/fr/glossary/throughput/)

Le débit (throughput), dans le service de LLM, est la quantité totale de travail qu’un système accomplit par unité de temps sur toutes les requêtes simultanées, généralement mesurée en tokens de sortie par seconde ou en requêtes par seconde. Il se distingue de la vitesse par flux, c’est-à-dire la vitesse à laquelle une seule requête reçoit ses tokens.

[Liste d’IP autorisées (IP allow list)](https://broadrouter.com/fr/glossary/ip-allow-list/)

Une liste d’IP autorisées est un contrôle de sécurité qui n’accepte que les requêtes provenant d’adresses IP ou de plages CIDR listées et refuse toutes les autres. Sur une API, elle limite les dégâts d’une clé divulguée, car la clé ne fonctionne pas depuis des réseaux absents de la liste.

## Questions fréquentes

### Faut-il réessayer une erreur 429 d’une API LLM ?

Oui, avec un backoff exponentiel borné. Sur BroadNet Inference, un 429 signifie qu’une limite de débit, de concurrence, de tokens par minute ou de dépenses est atteinte. Réduisez le parallélisme si cela se répète, et arrêtez de réessayer quand la cause est une limite de dépenses.

### Pourquoi ai-je un 401 alors que ma clé est correcte ?

Chez BroadNet, un 401 couvre aussi un quota de paiement à l’usage épuisé ou un budget bloqué, pas seulement une clé erronée ou expirée. Vérifiez le solde du compte et le statut de la clé sur la page du compte.

### Quelle est la différence entre 401 et 403 ici ?

Un 401 concerne la clé ou le quota du compte. Un 403 signifie que la clé fonctionne, mais que la requête est refusée par une politique de modèle, de route ou d’IP, par exemple un appel depuis une adresse absente de la liste d’IP autorisées.

### Le SDK OpenAI réessaie-t-il automatiquement ?

Oui. Par défaut, le SDK Python d’OpenAI réessaie deux fois les erreurs de connexion, 408, 409, 429 et 5xx, avec un court backoff exponentiel. Réglez max\_retries pour changer le nombre, ou 0 pour désactiver les nouvelles tentatives.

## Guides associés

-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [Limiter vos clés API à vos serveurs avec une liste d’IP autorisées](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/)
-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

[Commencer](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-errors-and-retries&utm_content=page-cta) ·

**Sources**

-   [Référence de l’API de BroadNet Inference, erreurs et nouvelles tentatives (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-errors-and-retries&utm_content=sources#errors)
-   [Référence de l’API de BroadNet Inference, limites (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-errors-and-retries&utm_content=sources#limits)
-   [README du SDK Python d’OpenAI, nouvelles tentatives et délais (consulté le 2026-11-14)](https://github.com/openai/openai-python#retries)
