> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestionar errores de API y reintentos con CometAPI

> Gestiona los errores de CometAPI separando los problemas de forma de la solicitud, fallos de autenticación, límites de tasa y fallos temporales de la plataforma que se pueden reintentar.

Gestiona los errores de CometAPI decidiendo si la solicitud debe corregirse o reintentarse. Reintenta `429`, fallos de tipo timeout y fallos temporales del servidor con backoff; no reintentes solicitudes mal formadas ni fallos de autenticación.

## Reintenta solo los fallos reintentables

| Status o señal              | ¿Reintentar?   | Acción                                                            |
| --------------------------- | -------------- | ----------------------------------------------------------------- |
| `400`                       | No             | Corrige el cuerpo de la solicitud o los parámetros.               |
| `401`                       | No             | Corrige la API key y el encabezado `Authorization`.               |
| `403`                       | Normalmente no | Elimina los campos no compatibles y verifica el acceso al modelo. |
| `429`                       | Sí             | Reintenta con backoff exponencial y jitter.                       |
| `500` con `invalid_request` | No             | Corrige la forma de la solicitud.                                 |
| `500`, `503`, `504`, `524`  | Sí             | Reintenta con backoff y conserva el ID de solicitud.              |

## Agrega backoff

El siguiente ejemplo en Python reintenta solo los fallos reintentables:

```python theme={null}
import os
import random
import time
from openai import APIError, OpenAI, RateLimitError

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

for attempt in range(5):
    try:
        response = client.chat.completions.create(
            model="your-model-id",
            messages=[{"role": "user", "content": "Say hello."}],
        )
        print(response.choices[0].message.content)
        break
    except RateLimitError:
        delay = min(30, 2**attempt) + random.random()
        time.sleep(delay)
    except APIError as error:
        status_code = getattr(error, "status_code", None)
        if status_code in {500, 503, 504, 524}:
            delay = min(30, 2**attempt) + random.random()
            time.sleep(delay)
            continue
        raise
else:
    raise RuntimeError("The request failed after retries.")
```

La respuesta correcta incluye la salida del modelo:

```json theme={null}
{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello."
      }
    }
  ],
  "usage": {
    "total_tokens": 9
  }
}
```

## Registra contexto útil

La siguiente estructura JSON es segura para almacenarla después de eliminar secretos de usuario y archivos grandes:

```json theme={null}
{
  "method": "POST",
  "path": "/v1/chat/completions",
  "model": "your-model-id",
  "status": 429,
  "request_id": "request_id_from_error_message",
  "retryable": true
}
```

## Errores comunes

| Error                                | Solución                                                            |
| ------------------------------------ | ------------------------------------------------------------------- |
| Reintentar `401`                     | Detén los reintentos y rota o vuelve a cargar la API key.           |
| Reintentar JSON no válido            | Valida el cuerpo de la solicitud antes de enviar otra solicitud.    |
| No hay ID de solicitud en los logs   | Captura el cuerpo exacto del error antes de que tu SDK lo envuelva. |
| Reintento inmediato después de `429` | Agrega jitter y reduce la concurrencia.                             |

## Enlaces relacionados

* [Códigos de error y manejo](/es/errors/error-codes-handling)
* [Límites de tasa y concurrencia](/es/guides/rate-limits-and-concurrency)
* [Página de modelos](/es/overview/models)
* [Directorio de modelos](https://www.cometapi.com/models/)
* [Precios](https://www.cometapi.com/pricing/)
* [Inicio rápido de CometAPI](/es/overview/quick-start)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/guides/error-codes-and-retry-strategy",
        "headline": "¿Cómo manejo los códigos de error y los reintentos con CometAPI?",
        "description": "Gestiona los errores de CometAPI separando los problemas de estructura de la solicitud, los fallos de autenticación, los límites de tasa y los fallos de plataforma reintentables.",
        "url": "https://apidoc.cometapi.com/guides/error-codes-and-retry-strategy",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentación de CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Guías",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "¿Cómo manejo los códigos de error y los reintentos con CometAPI?",
            "item": "https://apidoc.cometapi.com/guides/error-codes-and-retry-strategy"
          }
        ]
      }
    ]
    }
    `}
</script>