Cómo solucionar el error "Invalid API Key" (OpenAI / Claude API) — errores de autenticación 401

Qué significa este error

Las API compatibles con OpenAI esperan una clave API en el encabezado Authorization:

Authorization: Bearer sk-proj-...

La API de Messages de Anthropic usa x-api-key en su lugar:

x-api-key: sk-ant-...

Cuando la clave falta, está mal formada, caducada o emitida para un servicio diferente, obtienes 401 con un JSON como:

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

Las respuestas de Claude / Anthropic son similares (authentication_error, invalid x-api-key). Los relays de terceros a menudo reenvían el mensaje original tal cual, por lo que puedes ver el mismo texto incluso cuando el problema real es URL base incorrecta o una clave de revendedor muerta.

Esto no es un error 400 de moderación de contenido ni un límite de tasa 429 — la autenticación falla antes de que importen las comprobaciones de cuota o seguridad.

Causas comunes

1. Error tipográfico o clave truncada — al copiar/pegar se perdieron caracteres, o la interfaz mostró sk-...XXXX y pegaste la versión enmascarada.
2. Espacios en blanco o comillas en .env — OPENAI_API_KEY=" sk-..." o un salto de línea final rompe la autenticación silenciosamente en algunos SDK.
3. Nombre de encabezado incorrecto — usar Bearer en Anthropic, o x-api-key en OpenAI, u olvidar el encabezado por completo.
4. base_url incorrecta — clave de OpenAI enviada al host de Anthropic (o viceversa); clave de relay enviada a api.openai.com en lugar del endpoint del revendedor.
5. Clave revocada o rotada — clave eliminada en el panel, organización cambiada, o cuenta de relay suspendida por falta de pago.
6. Desajuste entre clave de proyecto y clave heredada — las claves de ámbito de proyecto de OpenAI (sk-proj-) están vinculadas a un ID de proyecto que tu SDK no pasa correctamente.
7. Prueba gratuita caducada / saldo vacío en relay — algunas puertas de enlace devuelven un invalid api key genérico cuando la cuenta está deshabilitada, aunque el formato de la cadena parezca válido.

Cómo solucionarlo

1. Verifica la clave con una solicitud en vivo

Usa el Probador de claves API: ingresa tu clave, una URL base opcional personalizada, elige un modelo, haz clic en Probar. Verás inmediatamente la latencia, el estado HTTP y la respuesta del modelo — la forma más rápida de separar clave mala de endpoint incorrecto o caída del proveedor.

Prueba tu clave API gratis →

2. Revisa la configuración del encabezado y del SDK

OpenAI Python:

from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.openai.com/v1")  # o tu URL de relay
client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "ping"}])

Anthropic Python:

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-...")
client.messages.create(model="claude-sonnet-4-20250514", max_tokens=16, messages=[{"role": "user", "content": "ping"}])

Asegúrate de que el nombre de la variable de entorno coincida con lo que lee tu herramienta (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.).

3. Haz coincidir la URL base con la fuente de la clave

Clave de	URL base típica
OpenAI oficial	https://api.openai.com/v1
Anthropic oficial	https://api.anthropic.com (API de Messages)
APIMaster / relay	https://apimaster.ai/v1 (compatible con OpenAI)

Usar una clave de APIMaster contra api.openai.com siempre falla — y lo contrario ocurre con las claves oficiales en hosts de relay.

4. Regenera y actualiza los secretos

Si la clave se filtró, rotó o se compartió en un repositorio, crea una nueva clave en la consola del proveedor, actualiza CI/CD y .env, y revoca la anterior.

5. Confirma el estado de la cuenta

Para API oficiales: facturación activa, organización no suspendida. Para relays: saldo > 0, cuenta no bloqueada. Algunas plataformas enmascaran fallos de facturación como errores de autenticación.

Cómo ayuda APIMaster

¿Aún estancado o necesitas una clave funcional nueva? APIMaster es una API agregada compatible con OpenAI construida sobre tres fortalezas:

Ventaja	Lo que obtienes
Descuento	Precios del Marketplace — hasta ~90 % de descuento sobre las tarifas de OpenAI y ~85 % de descuento sobre las de Claude (precios en vivo en el sitio).
Estabilidad	Un solo endpoint https://apimaster.ai/v1 y una clave para muchos modelos — menos desajustes host/clave que parecen errores de clave API inválida; respaldo multicanal.
Fidelidad del modelo	Una clave válida aún puede servir el modelo incorrecto — verifica con detección de huella digital. Prueba la conectividad primero: Probador de claves API.

Desde $1 de recarga, pago por uso, sin suscripción.

Regístrate en APIMaster →

Errores de API relacionados

• Error de API 400: mensajes con contenido bloqueado — moderación, no autenticación
• Límite de tasa de OpenAI excedido — 429 después de que la autenticación tenga éxito
• Claude / Anthropic 529 sobrecargado — capacidad con una clave válida
• Ubicación no compatible de ChatGPT — región bloqueada
• Todas las guías de solución de errores de API — índice completo

Preguntas frecuentes

¿Qué significa "invalid api key" en OpenAI? El servidor rechazó tu encabezado Authorization — clave incorrecta, formato incorrecto, clave revocada o clave usada en el host de API equivocado. Regenera la clave o verifícala con el Probador de claves API.

¿Por qué Claude dice "invalid x-api-key"? Anthropic requiere la clave sin procesar en el encabezado x-api-key (no Bearer). Vuelve a verificar el nombre del encabezado y que estés llamando a api.anthropic.com, no a una URL compatible con OpenAI.

¿Puede fallar una clave que parece válida? Sí — si la cuenta está deshabilitada, el proyecto fue eliminado o llegaste a la base_url incorrecta. Siempre prueba con una solicitud mínima o con el Probador de claves.

¿APIMaster usa autenticación Bearer estilo OpenAI? Sí. APIMaster es compatible con OpenAI: Authorization: Bearer <tu-clave-apimaster> y base_url=https://apimaster.ai/v1.