Error 401 de OpenAI «Incorrect API key provided»: guía esencial con los 3 pasos oficiales, probada (2026)

Respuesta corta: OpenAI responde 401 Incorrect API key provided cuando la clave que envía tu petición no coincide con una clave válida. La solución oficial son tres pasos: borrar la caché y las cookies del navegador, revisar la clave de la cabecera y, si no estás seguro de que sea correcta, crear una nueva y cambiar la vieja en todas partes. El mensaje muestra los cuatro últimos caracteres de la clave enviada, así que puedes ver qué clave usa de verdad tu código. El 29 de octubre de 2026 enviamos claves incorrectas a la API nosotros mismos; abajo están las respuestas reales.

Qué dice el error

Una petición con una clave incorrecta devolvió exactamente esto:

{
  "error": {
    "message": "Incorrect API key provided: sk-test123. You can find your API key at https://platform.openai.com/account/api-keys.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

La guía de códigos de error de OpenAI da como causa «The requesting API key is not correct» (la clave de la petición no es correcta) y enumera cuatro casos:

• La clave tiene una errata o un espacio de más.
• La clave es de otra organización o de otro proyecto.
• La clave se borró o se desactivó.
• Hay una clave antigua y revocada guardada en local.

Los 3 pasos oficiales

1. Borra la caché y las cookies del navegador y vuelve a probar. Sirve si copias la clave desde el panel o usas una herramienta web que guardó una antigua.

2. Comprueba que la cabecera de la petición lleva la clave correcta, con el formato Authorization: Bearer .

3. Si no estás seguro, crea una clave nueva en la página de claves. Después cambia la vieja en el código y en cualquier sitio donde esté guardada, siguiendo las buenas prácticas de seguridad para claves de API de OpenAI.

Lo que obtuvimos al probarlo

El 29 de octubre de 2026 lanzamos estas peticiones desde una máquina de prueba con curl y openai-python 3.40.0.

El mensaje muestra los 4 últimos caracteres

Con una clave de proyecto falsa de 56 caracteres, el mensaje ocultó el centro y dejó el final:

"message": "Incorrect API key provided: sk-proj-********************************************56w1. ..."

Es la comprobación más rápida: compara esos cuatro caracteres con la clave de la página de claves. Si no coinciden, tu código está leyendo otra clave. Las cadenas cortas de prueba como sk-test123 aparecen completas.

Sin Bearer el mensaje es otro

Sin cabecera Authorization, o con la cabecera pero sin la palabra Bearer, la API no dijo Incorrect API key provided, sino:

"message": "Missing bearer authentication in header"

Con Bearer y la clave vacía, respondió Incorrect API key provided: ''. Suele significar que la variable que pusiste en la cabecera estaba vacía.

Un espacio o salto de línea al final ni siquiera llega a OpenAI

Con la clave en OPENAI_API_KEY y un espacio o un salto de línea al final, openai-python no recibió un 401: falló antes de enviar.

APIConnectionError | Connection error. | LocalProtocolError("Illegal header value b'Bearer sk-test123 '")

O sea, un «Connection error» del SDK puede ser un problema de la clave y no de la red. Con printf '%s' "$OPENAI_API_KEY" | od -c | tail -3 ves si hay caracteres invisibles al final. Sin ninguna clave definida, el SDK se detiene con OpenAIError: Missing credentials.

No pudimos probar una clave real ya borrada ni una de otra organización, porque harían falta claves reales de una cuenta. Según la documentación de OpenAI, las dos dan el mismo Incorrect API key provided.

Averigua qué clave envía tu código

Muchas herramientas leen la clave de varios sitios, y un valor antiguo puede tener prioridad. Revisa:

• OPENAI_API_KEY en la terminal donde corre el programa.
• El archivo .env: comillas copiadas dentro del valor y espacios detrás.
• La configuración de la propia herramienta. Por ejemplo, Codex CLI puede iniciar sesión con una clave de API; nuestra guía para instalar Codex CLI explica dónde se define.
• Secretos del CI y variables del servidor que aún guardan una clave que borraste.

Si la clave antigua llegó a subirse a un repositorio público o se pegó en algún sitio visible, no basta con cambiarla: bórrala en la página de API keys y sigue los pasos para una API key filtrada. Y si el 401 desaparece pero empiezas a recibir un 429, ya es un límite de velocidad o de facturación; lo explico en el 429 de la API de OpenAI: rate limit o insufficient_quota.

Preguntas frecuentes

¿401 Incorrect API key provided es lo mismo que «Invalid Authentication»?

No. OpenAI lista aparte «401 – Invalid Authentication», con la solución «Ensure the correct API key and requesting organization are being used». Incorrect API key provided trata de la clave en sí.

¿Un 403 puede ser un problema de clave?

El de país no. 403 Country, region, or territory not supported depende de desde dónde sale la petición y una clave nueva no lo cambia. Lo explicamos en nuestra guía de ese 403.

¿ChatGPT Plus incluye una clave de API?

No. Los planes de ChatGPT y la API se pagan por separado. Lo comparamos en ChatGPT Plus o API.