---
title: "Errores 401, 402, 409 y 429 de API de LLM: cuándo reintentar"
description: "Qué significa cada código HTTP de la API de BroadNet Inference, cuáles reintentar con backoff, cuáles corregir antes y qué enviar al soporte con el ID de solicitud."
url: https://broadrouter.com/es/guides/errors-and-retries/
lang: es
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/errors-and-retries/) (actualizado el 2026-11-14).

# Códigos de error de BroadNet Inference y cuándo reintentar

Actualizado 2026-11-14

Revise el código de estado HTTP antes de procesar el cuerpo. Reintente los errores 429 y 5xx con backoff exponencial acotado. Corrija 400, 403, 413 y 422 antes de reintentar. Ante un 401, revise la clave y el saldo; ante un 402, agregue fondos a la cuenta. Registre siempre el encabezado X-Request-ID para el soporte.

La API devuelve un código de estado HTTP normal y un código de error legible por máquina. Elija el siguiente paso según el código de estado. Esta tabla sigue la [referencia de la API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-errors-and-retries&utm_content=body#errors) de BroadNet.

| Estado | Qué significa | Qué hacer |
| --- | --- | --- |
| 400 / 422 | Solicitud o campo no válido | Corrija primero la solicitud |
| 401 | Clave ausente, no válida o vencida, presupuesto de pago por uso bloqueado o asignación agotada | Revise el estado de la clave y el saldo de la cuenta |
| 402 `insufficient_balance` | La cuenta no puede cubrir una compra; el cuerpo incluye el saldo y el precio | Agregue fondos a la cuenta y vuelva a intentar |
| 403 | Rechazada por una política de modelo, ruta o IP | Corrija la discrepancia, por ejemplo [una lista de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/) |
| 409 | Conflicto con el estado de la cuenta: `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Reintente solo `mint_in_progress`, con el mismo `request_id` |
| 413 | Solicitud demasiado grande; los archivos de transcripción tienen un máximo de 26,214,400 bytes | Reduzca la solicitud |
| 429 | Se alcanzó un límite de frecuencia, concurrencia, tokens por minuto o gasto | Lea los detalles de la respuesta, aplique backoff y reintente |
| 500 / 502 / 503 / 504 | Procesamiento del lado del servidor | Reintente con backoff exponencial acotado; reutilice el mismo `request_id` en las compras de claves por hora |

La documentación de BroadNet indica revisar el código de estado HTTP antes de procesar un cuerpo JSON, y luego leer el código `error` legible por máquina cuando exista.

## ¿Qué límites provocan un 429?

Una clave de pago por uso permite 30 solicitudes por minuto y 4 solicitudes en curso al mismo tiempo. La documentación de BroadNet asigna a una clave por hora 120 solicitudes por minuto, un stream y 300,000 tokens por minuto. En un [plan ilimitado](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/), cada sesión ejecuta una solicitud a la vez. Para comparar estos límites con los de OpenAI, Anthropic, Groq y DeepSeek, lea [límites de frecuencia de las APIs de LLM por proveedor](https://broadrouter.com/es/blog/llm-api-rate-limits-by-provider/).

## ¿Cómo reintento con el SDK de OpenAI?

El SDK de OpenAI para Python ya reintenta los errores de conexión y las respuestas 408, 409, 429 y 5xx dos veces de forma predeterminada, con un backoff exponencial corto, según su [README en GitHub](https://github.com/openai/openai-python#retries). Su tiempo de espera predeterminado es de 10 minutos. Configure ambos valores de forma explícita:

```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
)
```

## ¿Cómo escribo mi propio backoff?

Si llama a la API sin un SDK, limite tanto la cantidad de intentos como el tiempo de espera:

```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
```

Nunca reintente sin cambios un 400, 403, 413 o 422: la misma solicitud fallará de la misma manera. Cada reintento de una solicitud de chat es una nueva inferencia y se factura de nuevo en el pago por uso. Consulte [backoff exponencial](https://broadrouter.com/es/glossary/exponential-backoff/) para ver el patrón general.

## Reintentar de forma segura la compra de una clave por hora

`POST /portal/keys/hourly` recibe un `request_id`. Después de un tiempo de espera agotado, una conexión perdida, un 409 `mint_in_progress` o un 5xx, reintente con el **mismo** `request_id`. Un `request_id` reutilizado nunca crea ni cobra una segunda clave; la repetición devuelve `already_issued: true` y el alias. Nunca genere un id nuevo hasta conocer el resultado del primero. Más información sobre [claves de idempotencia](https://broadrouter.com/es/glossary/idempotency-key/).

## Solución de problemas

-   **401 justo después de una recarga.** La página de la cuenta de BroadNet muestra la última asignación registrada y marca un cambio de fondos como en actualización mientras se aplica. Actualice la página y vuelva a intentar cuando haya terminado.
-   **429 con pocas solicitudes por minuto.** Probablemente está alcanzando el límite de concurrencia de 4 solicitudes, por ejemplo con streams largos en paralelo. Use un grupo de workers pequeño.
-   **403 en un modelo pero no en otro.** La política de la clave no cubre ese modelo o ruta. Las claves de plan, por ejemplo, son para `broadnet/deepseek-v4.1-flash`, y una clave por hora solo cubre `broadnet/gemma-4-26b-a4b`.
-   **El SDK reintentó y se le cobró dos veces.** Una solicitud de chat reintentada es una nueva inferencia. Configure `max_retries=0` donde una respuesta duplicada cueste más que una fallida.

## Qué enviar al soporte

Incluya el valor del encabezado `X-Request-ID`, la marca de tiempo UTC, la ruta, el código de estado HTTP y el alias de su clave. Nunca envíe la clave. La [guía del SDK de OpenAI para Python](https://broadrouter.com/es/guides/openai-python-sdk/) muestra cómo leer el encabezado.

## Términos de esta guía

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Timeout de solicitud (tiempo de espera)](https://broadrouter.com/es/glossary/request-timeout/)

Un timeout de solicitud es el tiempo máximo que un cliente HTTP espera a un servidor antes de abandonar la solicitud. Los clientes suelen dividirlo en un timeout de conexión, para abrir la conexión, y uno de lectura, para esperar los datos. Las llamadas a LLMs necesitan timeouts de lectura generosos porque las respuestas largas tardan.

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

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[Backoff exponencial (exponential backoff)](https://broadrouter.com/es/glossary/exponential-backoff/)

El backoff exponencial es una estrategia de reintento en la que el cliente espera más tiempo tras cada intento fallido, normalmente duplicando la espera hasta un tope, antes de volver a intentarlo. Añadir jitter aleatorio a cada espera dispersa los reintentos de muchos clientes para que no lleguen al servidor en el mismo instante.

[Crédito prepago (prepaid credit)](https://broadrouter.com/es/glossary/prepaid-credit/)

El crédito prepago es dinero que se añade a una cuenta de API antes de usarla. Cada solicitud descuenta su coste del saldo y, cuando el saldo se agota, las solicitudes medidas se detienen hasta que usted recargue. Limita el gasto a lo que ha pagado.

[Lista de IP permitidas (IP allow list)](https://broadrouter.com/es/glossary/ip-allow-list/)

Una lista de IP permitidas es un control de seguridad que solo acepta solicitudes de direcciones IP o rangos CIDR incluidos en ella y rechaza todas las demás. En una API, limita el daño de una clave filtrada, porque la clave no funciona desde redes que no estén en la lista.

## Preguntas frecuentes

### ¿Debo reintentar un error 429 de una API de LLM?

Sí, con backoff exponencial acotado. En BroadNet Inference, un 429 significa que se alcanzó un límite de frecuencia, de concurrencia, de tokens por minuto o de gasto. Reduzca el paralelismo si se repite y deje de reintentar cuando la causa sea un límite de gasto.

### ¿Por qué recibo un 401 si mi clave es correcta?

En BroadNet, un 401 también cubre una asignación de pago por uso agotada o un presupuesto bloqueado, no solo una clave incorrecta o vencida. Revise el saldo de la cuenta y el estado de la clave en la página de la cuenta.

### ¿Cuál es la diferencia entre 401 y 403 aquí?

Un 401 tiene que ver con la clave o con la asignación de la cuenta. Un 403 significa que la clave funciona, pero una política de modelo, ruta o IP rechazó la solicitud; por ejemplo, una llamada desde una dirección que no está en la lista de IP permitidas.

### ¿El SDK de OpenAI reintenta los errores automáticamente?

Sí. El SDK de OpenAI para Python reintenta los errores de conexión, 408, 409, 429 y 5xx dos veces de forma predeterminada, con un backoff exponencial corto. Configure max\_retries para cambiar la cantidad, o 0 para desactivar los reintentos.

## Guías relacionadas

-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [Limite sus claves de API a sus servidores con listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

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

**Fuentes**

-   [Referencia de la API de BroadNet Inference, errores y reintentos (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-errors-and-retries&utm_content=sources#errors)
-   [Referencia de la API de BroadNet Inference, límites (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-errors-and-retries&utm_content=sources#limits)
-   [README del SDK de OpenAI para Python, reintentos y tiempos de espera (consultado el 2026-11-14)](https://github.com/openai/openai-python#retries)
