Titikey
InicioCentro de ayudaLista de verificación para diagnosticar errores 401/403/429 en las APIs de ChatGPT, Claude, Gemini y Midjourney

Lista de verificación para diagnosticar errores 401/403/429 en las APIs de ChatGPT, Claude, Gemini y Midjourney

2/2/2026
帮助中心

Al conectar un sistema de escritura automatizada, bots y RAG, lo más desesperante no es que el resultado sea normalito, sino que la API de repente te estampe en la cara un 401/403/429. A mí también me pasó: la Key estaba bien, y aun así daba error, como si estuvieras discutiendo con el aire.

Primero entiende tres errores frecuentes

  • 401 Unauthorized: Key inválida, espacios extra al pegar, o usar la Key del proyecto equivocado
  • 403 Forbidden: restricciones por región/permisos/políticas de la organización, o la cuenta no tiene habilitada la capacidad correspondiente
  • 429 Too Many Requests: se activó el rate limit, demasiada concurrencia, o se alcanzó el tope de cuota o de velocidad

Causas comunes de errores en la API de ChatGPT

El punto donde más suelo “volcar” es: que la Key en las variables de entorno tenga saltos de línea al inicio o al final; y también que la facturación no esté bien configurada pero uno piense “si funciona, ya está”. Cuando aparece un 429, baja la concurrencia y añade reintentos con backoff exponencial: la experiencia se normaliza de inmediato.

En Claude es más fácil quedarse atascado en permisos

Muchos 403 de Claude no son porque lo hayas programado mal, sino porque la cuenta/la región/las políticas corporativas no lo permiten. Además, equivocarte con el nombre del modelo también puede hacerte dudar de tu vida; conviene volver a revisar el campo del modelo en la petición.

En Gemini lo típico es la cuota y la configuración del proyecto

Si Gemini devuelve 429, no te apresures a culpar al modelo: primero revisa la cuota del proyecto, los límites de frecuencia de llamada y si la API vinculada a la Key está habilitada; a algunos solo les da tiempo a crear la Key y se les olvida activar el servicio correspondiente en la consola.

Midjourney se parece más a un problema del lado de Discord

Midjourney no es un flujo de API tradicional; es más interacción con Discord. Los “no funciona” habituales vienen de: permisos del canal no concedidos, el bot no está en el servidor, el formato del comando es incorrecto o hay limitación de tasa. Confirma primero que el bot puede ver tu canal: es más fiable que cambiar el prompt una y otra vez.

Mi orden de comprobación universal

  • Copiar la Key de nuevo y borrar manualmente espacios y saltos de línea al principio y al final
  • Confirmar que la red es estable: no ir alternando entre conexión directa y proxy
  • Bajar la concurrencia a 1 para probar, y luego ir subiéndola poco a poco
  • Leer bien el campo de error del cuerpo de la respuesta; no fijarse solo en el código de estado

Si todavía estás dando vueltas con esas “barreras invisibles” como suscripciones, cuota o restricciones regionales, puedes echar un vistazo a Titikey para ver tutoriales prácticos más detallados y una recopilación de herramientas, y así evitar muchos rodeos innecesarios.

InicioTiendaPedidos