Errores, reintentos y límites

Live

Clasifica los fallos antes de reintentar y conserva el contexto de la petición original.

(opens in new tab)Última verificación: 2026-08-11

Clases de error

Estado	Significado	Acción
400 / 413	Entrada no válida o petición demasiado grande	Corrige la petición; no la reintentes sin cambios
401	Clave ausente o no válida	Rota o corrige las credenciales
402	Límite de facturación o de saldo	Resuelve la facturación antes de reintentar
429	Límite de uso alcanzado	Respeta Retry-After y aplica retroceso
5xx	Fallo transitorio del servicio o del proveedor	Reintenta un número acotado de veces

Política de reintentos

Usa retroceso exponencial con jitter, un número máximo pequeño de intentos y un plazo global. Conserva los IDs de petición y los cuerpos de error, pero elimina credenciales y entradas sensibles.

Límites de payload

Valida el número de caracteres, el número de archivos, los bytes y la compatibilidad del modelo antes de enviar. Lee los límites desde el descubrimiento de modelos cuando estén disponibles. El historial de chat no se descarta en silencio: los cuerpos de petición que superan el límite de bytes del gateway devuelven request_too_large, y el desbordamiento del contexto del modelo devuelve context_length_exceeded.

AnteriorWebhooks

SiguienteConservación de datos