Lista de verificación para diagnosticar errores de claves API de ChatGPT, Claude y Gemini: haz que tus solicitudes vuelvan a funcionar de inmediato

Lo más desesperante no es que el modelo no sea lo bastante inteligente, sino que justo después de escribir un bloque de código para llamarlo te suelte de golpe Invalid API Key, 403 o “fallo de conexión de red”. Reuní los tropiezos que yo mismo sufrí en una lista de verificación general aplicable a ChatGPT OpenAI, Claude Anthropic y Gemini; de paso también menciono un problema de permisos común en Midjourney.

Tres tipos de problemas que se arreglan de un vistazo

Clave mal pegada o puesta en un proyecto antiguo

Mucha gente pega espacios antes o después de la Key, o pone la Key del entorno de pruebas en producción. Te recomiendo copiar la Key a un texto plano para echarle un vistazo y luego pegarla de nuevo.

Solicitud enviada al endpoint equivocado o con el nombre del modelo incorrecto

Escribir mal el nombre del modelo también puede hacerte creer que la Key está mal. No te emperres: siguiendo la idea de “mantenerlo simple” (el KISS de toda la vida sí funciona), primero haz que corra el ejemplo oficial más básico, y luego ya añades parámetros.

Las dependencias del entorno te arrastran

Si estás usando un plugin o un scaffold ya hecho (por ejemplo, en Node son comunes conflictos de dependencias tipo ETARGET, ERESOLVE), primero deja las dependencias limpias y alinea versiones; si no, vas a perder una hora en falso con el “error de Key”.

Cómo manejar el 403 (acceso restringido) y los problemas de red

Si te sale 403, restricciones por región o avisos tipo “solución de problemas de conexión de red”, revisa primero el proxy de la empresa, la pasarela y la ruta de salida internacional del servidor en la nube. Muchas veces no es que el modelo te rechace; es tu red la que está estropeando TLS o la resolución DNS.

Midjourney no usa API, pero tiene puntos de fallo parecidos

Midjourney se usa principalmente en Discord, y los problemas comunes son más bien: no estás en el servidor correcto, no tienes permisos en el canal, o la suscripción venció y los comandos no responden. No te pongas a cambiar código en local a lo loco: primero revisa permisos y estado de suscripción en Discord.

Mi orden habitual para localizar rápido

• Verificar si devuelve resultado con la solicitud mínima
• Probar con otra red o desactivar el proxy corporativo
• Regenerar la Key y reemplazar inmediatamente la variable de entorno
• Confirmar que el nombre del modelo, el dominio del endpoint y la configuración de región coinciden

Si aún estás atascado en temas de recarga, suscripción o acceso por región de esos de “te paran en la puerta”, te sugiero echar un vistazo a Titikey para una solución más cómoda; yo lo comparé y, de verdad, vale la pena toquetear menos.