Errores OpenAI Codex: tabla rápida con los mensajes de la API, ChatGPT y Codex (2026)
Una tabla rápida con los mensajes de error de la API de OpenAI, ChatGPT y Codex: el texto exacto, la causa probable en una línea, de dónde sale la respuesta y el enlace a la guía completa.
bufferSobre el autor4 min de lectura
Aquí reunimos los errores OpenAI Codex sobre los que tenemos una guía completa, tanto de la API de OpenAI como de ChatGPT y de Codex. Busca el texto exacto que ves, lee la causa probable y abre la guía para arreglarlo. La columna «Base» indica de dónde sale cada respuesta: «Probado» significa que la guía muestra una salida que obtuvimos nosotros, y el resto se apoya en la documentación de OpenAI, el código de Codex o issues de GitHub.
Errores de la API de OpenAI
Estos errores los devuelve la API o los SDK oficiales. OpenAI tiene la lista completa de códigos HTTP en su guía de códigos de error.
| Mensaje de error | Causa probable | Base | Guía completa |
|---|---|---|---|
401 Incorrect API key provided: sk-... | La clave está mal, se borró, es de otra organización o proyecto, o sigue configurada una clave antigua en una variable de entorno. | Probado | Cómo arreglar el 401 |
Missing bearer authentication in header | La petición no lleva la cabecera Authorization: Bearer, así que la clave nunca llegó a OpenAI. | Probado | Qué obtuvimos con cada clave mala |
APIConnectionError con Illegal header value b'Bearer sk-... ' | La clave tiene un espacio o un salto de línea al final y el SDK de Python se niega a enviarla. | Probado | Busca caracteres ocultos en la clave |
OpenAIError: Missing credentials | El SDK no encontró ninguna clave, casi siempre porque OPENAI_API_KEY no está definida en esa terminal o proceso. | Probado | De dónde se lee la clave |
403 Country, region, or territory not supported (unsupported_country_region_territory) | La máquina que envía la petición está en un lugar que OpenAI no admite. Cambiar la clave o reintentar no sirve. | Documentación y reportes del foro | Cómo resolver el 403 |
429 Rate limit reached for requests | Mandaste más peticiones o tokens por minuto de los que permite tu límite. Basta con esperar y reintentar con espera progresiva. | Documentación; reintentos del SDK comprobados con un servidor simulado | El 429 de la API de OpenAI |
429 con el código insufficient_quota (o credit_balance_exhausted) | Se acabó el saldo o llegaste a un límite de gasto. Reintentar no sirve: añade saldo o sube el límite. | Documentación; reintentos del SDK comprobados con un servidor simulado | Límite de tasa frente a cuota |
Si el 401 empieza justo después de subir una clave a GitHub o pegarla en un sitio público, puede que OpenAI la haya desactivado a propósito. OpenAI dice que desactiva las claves que encuentra publicadas en internet. Sigue nuestros pasos para una API key filtrada antes de crear otra.
Errores de ChatGPT
| Mensaje de error | Causa probable | Base | Guía completa |
|---|---|---|---|
Payment was not approved | El banco o el emisor de la tarjeta rechazó el cobro, o no terminaste la verificación 3D Secure. OpenAI dice que normalmente no recibe el motivo, así que lo más rápido es preguntar al banco. | Centro de ayuda de OpenAI | El orden oficial para resolverlo |
Errores de Codex (CLI, app y VS Code)
| Mensaje de error | Causa probable | Base | Guía completa |
|---|---|---|---|
Selected model is at capacity. Please try a different model. | A OpenAI le faltan servidores para ese modelo (server_is_overloaded). No es tu cuota. Espera unos minutos o cambia de modelo. | Código de Codex y mensajes de un mantenedor | Qué significa «at capacity» |
You've hit your usage limit | Se agotó el uso de Codex de tu plan de ChatGPT en el periodo actual. Ejecuta /status para ver cuándo se reinicia. | Código de Codex | Los mensajes 429 de Codex |
Quota exceeded. Check your plan and billing details. | Un problema de facturación: se acabó el saldo o llegaste a un límite de gasto. Reintentar no sirve. | Código de Codex | Los mensajes 429 de Codex |
exceeded retry limit, last status: 429 Too Many Requests | Un límite de tasa normal. Codex ya reintentó y se rindió. Espera y abre menos sesiones en paralelo. | Código de Codex | Los mensajes 429 de Codex |
To use Codex with your ChatGPT plan, upgrade to Plus | Tu plan no incluye Codex. | Código de Codex | Los mensajes 429 de Codex |
Codex could not start its user interface | Un fallo de la versión 26.1021.22027 de la extensión de Codex para VS Code. Volver a la 26.1007.21434 lo arregla en la mayoría de los casos. | Issue de GitHub; comparamos los dos paquetes | Cómo volver a la versión anterior |
Token exchange failed: token endpoint returned status 403 Forbidden | La petición de token del inicio de sesión no pasó por tu proxy y salió desde un país no admitido. Codex solo lee el proxy de las variables de entorno; SOCKS se escribe socks5://. | Issues de GitHub; nuestra prueba con codex-cli 0.165.0 | Arreglar el 403 |
Token exchange failed: error sending request for url | La petición no conectó: un puerto de proxy viejo (también en ~/.codex/.env), un certificado mal configurado o un inicio de sesión en una máquina remota. | Issues de GitHub; reprodujimos el caso del puerto viejo | Revisar cada causa |
Otros errores OpenAI Codex que no están aquí
Si el mensaje menciona Claude, Anthropic o un 529, no es un error de OpenAI. Mira nuestra lista de errores de Claude Code. Si aparecen varios errores de OpenAI a la vez, revisa status.openai.com antes de cambiar nada.