Copiaste la Key, y en cuanto ejecutas te sale 401, invalid_api_key, “API密钥错误”? No te quedes dudando de ti mismo: este tipo de problemas los he pisado demasiadas veces; muchas veces no es que “la Key sea incorrecta”, sino que el uso es incorrecto.
Los 3 tropiezos más comunes
Al copiar se cuelan espacios o saltos de línea
Al copiar la Key desde el panel, es muy fácil que al final se cuele un espacio/retorno de carro. Pega la Key en texto plano para revisarla y luego vuelve a pegarla: la tasa de éxito mejora a simple vista.
Tomaste la plataforma equivocada o los permisos equivocados
Una cuenta de ChatGPT no equivale a una cuenta de OpenAI API; con Claude y Gemini pasa igual: que el producto de chat funcione no significa que la API vaya a funcionar. Confirma que creaste la Key en la consola correspondiente y que el proyecto, la facturación y la cuota están habilitados.
La variable de entorno no surtió efecto
Muchos errores vienen de que “el programa ni siquiera leyó la Key”. Revisa si estás usando el nombre de variable correcto, reinicia la terminal/servicio y prueba de nuevo; en proyectos Node, no olvides cargar dotenv.
Los casos en los que no conecta también pueden disfrazarse como error de clave
Cuando la red está bloqueada, el proxy es inestable o el DNS falla, la librería puede soltarte directamente un error que parece “fallo de autenticación”. Puedes seguir algunas ideas típicas de diagnóstico: cambiar de red, desactivar proxys innecesarios, y usar curl para probar la conectividad del endpoint.
Por qué Midjourney también puede hacerte creer que es un problema de Key
Midjourney se usa principalmente en Discord; más a menudo son permisos del canal, formato de comandos o que el bot no está disponible lo que hace que “parezca que no tienes permiso”. No te obsesiones con la API Key: primero revisa si estás en el canal correcto y si tienes suscripción y permisos de uso.
Mi pequeña recomendación
Si conectas a la vez ChatGPT, Claude y Gemini, te recomiendo unificar las Keys en un gestor de secretos o en un gateway (por ejemplo, algunas ideas de gateways open source que soportan varios modelos), para reducir errores básicos como “pegar la Key equivocada”.
Si aún estás atascado con suscripciones, red o integración de herramientas, date una vuelta por Titikey: muchos problemas comunes ya tienen rutas de solución listas.
