Programar para conectarse a la API de ChatGPT/Claude/Gemini, o ponerse a generar en Midjourney a lo loco: lo más fastidioso no es no saber usarlo, sino que los errores “hablan como humanos pero no lo cuentan todo”. Organicé los tropiezos más comunes por síntomas en una lista de verificación; si la sigues tal cual, casi siempre podrás localizar el problema.
Error 1: Invalid API key / 401 fallo de autenticación
En la mayoría de casos no es que se te haya ido el dedo, sino que estás usando el “ojo de la cerradura” equivocado.
- Confirma que estás usando la Key de la plataforma correcta: OpenAI, Anthropic y Google usan cada uno su propia Key; no las mezcles.
- Elimina espacios y saltos de línea: al copiar a variables de entorno es muy fácil que se pegue un retorno de carro.
- Revisa la URL de la solicitud y el Header: si escribes mal el base_url o te falta el Bearer en Authorization, te lo devolverán sin piedad.
- Permisos y cuota: algunos modelos requieren habilitación aparte; si la cuenta tiene pagos pendientes o no tiene facturación vinculada, también puede parecer “Key inválida”.
Error 2: 403 / 429 acceso restringido o límite de frecuencia
Yo normalmente primero sospecho de la red y la región, y después sospecho de que me haya quedado un bucle infinito.
- 403 por región o control de riesgo: cambia a un entorno de red estable y evita cambiar de IP con frecuencia; las redes corporativas o universitarias también se bloquean con facilidad.
- 429 vas demasiado rápido: añade reintentos con backoff (por ejemplo, esperar 1 s, 2 s, 4 s) y no lleves la concurrencia al máximo.
Error 3: al instalar plugins aparece ETARGET / ERESOLVE / ENOTEMPTY
Mucha gente instala dependencias para integrar bots o flujos de trabajo, y al final se queda atascada en el gestor de paquetes, con ganas de reventar el teclado.
- ETARGET: ese número de versión no existe; cambia a una versión realmente publicada o actualiza tu npm/yarn.
- ERESOLVE: conflicto de dependencias; prueba a limpiar el archivo lock y, si hace falta, usa legacy-peer-deps.
- ENOTEMPTY: el directorio no se borró del todo; elimina node_modules y vuelve a instalar y se arregla.
Fallos comunes de Midjourney: Interaction failed o demasiada cola
- Interaction failed: suele ocurrir por inestabilidad de red o lag de Discord; reenvía el comando o prueba en otro canal.
- Cola/limitación de velocidad: en horas punta no fuerces; reduce la concurrencia o usa un ritmo de generación más “relajado”.
Si aún estás buscando enlaces por todas partes para el entorno de la cuenta, los canales de suscripción y las entradas de herramientas, te recomiendo pasarte por Titikey y, de paso, organizar de una vez tus herramientas de IA y soluciones habituales; el tiempo que ahorras te alcanza para sacar un par de imágenes más.
