Errores de la API de OpenAI

La API de OpenAI es una herramienta poderosa que permite a los desarrolladores crear aplicaciones y soluciones de inteligencia artificial de vanguardia. Sin embargo, como cualquier herramienta, puede haber problemas y errores que surjan durante el proceso de desarrollo. En este artículo, nos centraremos en los códigos de errores de la API de OpenAI, explicando qué son, por qué ocurren y cómo solucionarlos. Con esta información, los desarrolladores podrán identificar y resolver rápidamente cualquier problema que puedan encontrar al trabajar con la API de OpenAI.

401 - Invalid Authentication

Este es uno de los errores de la API de OpenAI que indica que tus credenciales de autenticación son inválidas. Esto puede ocurrir por varias razones, como:

- Estás utilizando una clave de API revocada

- Estás utilizando una clave de API diferente a la asignada a la organización que realiza la solicitud

- Estás utilizando una clave de API que no tiene los permisos necesarios para el endpoint que estás llamando

Para resolver este error, por favor sigue estos pasos:- Verifica que estás utilizando la clave de API y el ID de organización correctos en el encabezado de tu solicitud. Puedes encontrar tu clave de API y ID de organización en la configuración de tu cuenta

- Si no estás seguro de si tu clave de API es válida, puedes generar una nueva. Asegúrate de reemplazar tu antigua clave de API con la nueva en tus solicitudes y seguir la guía de mejores prácticas.

401 - Incorrect API key provided

Este mensaje de error indica que la clave de API que estás utilizando en tu solicitud no es correcta. Esto podría suceder por varias razones, como:

- Hay un error de escritura o un espacio adicional en tu clave de API

- Estás utilizando una clave de API que pertenece a una organización diferente

- Estás utilizando una clave de API que ha sido eliminada o desactivada

- Una clave de API antigua y revocada podría estar almacenada en caché localmente

Para resolver este error, por favor sigue estos pasos:- Intenta borrar la caché y las cookies de tu navegador, y luego intenta de nuevo

- Verifica que estás utilizando la clave de API correcta en el encabezado de tu solicitud

- Si no estás seguro de si tu clave de API es correcta, puedes generar una nueva. Asegúrate de reemplazar tu clave de API antigua en tu código y seguir la guía de mejores prácticas para no tener errores de la API de OpenAI.

401 - You must be a member of an organization to use the API

Este es otro de los errores de la API de OpenAI que indica que tu cuenta no forma parte de una organización. Esto puede suceder por varias razones, como:

- Has abandonado o te han eliminado de tu organización anterior

- Tu organización ha sido eliminada

Para resolver este error, por favor sigue estos pasos:- Si has abandonado o te han eliminado de tu organización anterior, puedes solicitar una nueva organización o que te inviten a una existente

- Para solicitar una nueva organización, contáctanos a través de help.openai.com

- Los propietarios de organizaciones existentes pueden invitarte a unirte a su organización a través del Panel de Miembros.

429 - Rate limit reached for requests

Otro de los errores de la API de OpenAI que indica que has alcanzado el límite de tasa asignado para la API. Esto significa que has enviado demasiados tokens o solicitudes en un corto período de tiempo y has excedido el número de solicitudes permitidas. Esto podría suceder por varias razones, como:

- Estás usando un bucle o un script que hace solicitudes frecuentes o concurrentes

- Estás compartiendo tu clave de API con otros usuarios o aplicaciones

- Estás usando un plan gratuito que tiene un límite de tasa bajo

Para resolver este error, por favor sigue estos pasos:

- Ajusta tus solicitudes y evita hacer llamadas innecesarias o redundantes

- Si estás usando un bucle o un script, asegúrate de implementar un mecanismo de espera o una lógica de reintentos que respete el límite de tasa y las cabeceras de respuesta. Puedes leer más sobre nuestra política de límites de tasa y mejores prácticas en nuestra guía de límites de tasa

- Si estás compartiendo tu organización con otros usuarios, ten en cuenta que los límites se aplican por organización y no por usuario. Vale la pena verificar el uso del resto de tu equipo ya que esto contribuirá al límite

- Si estás usando un plan gratuito o de bajo nivel, considera actualizar a un plan de pago por uso que ofrezca un límite de tasa más alto para no sufrir errores de la API de OpenAI. Puedes comparar las restricciones de cada plan en nuestra guía de límites de tasa.

429 - You exceeded your current quota, please check your plan and billing details

Este mensaje de error indica que has alcanzado tu límite mensual máximo para la API. Puedes ver tu límite mensual máximo en la sección de "límite duro" en la configuración de facturación de tu cuenta. Esto significa que has consumido todos los créditos asignados a tu plan y has alcanzado el límite de tu ciclo de facturación actual. Esto puede suceder por varias razones, como:

- Estás utilizando un servicio de alto volumen o complejo que consume muchos créditos o tokens

- Tu límite está establecido demasiado bajo para el uso de tu organización

Para resolver este error, por favor sigue estos pasos:

- Revisa tu cuota actual en la configuración de tu cuenta. Puedes ver cuántos tokens han consumido tus solicitudes en la sección de uso de tu cuenta

- Si estás utilizando un plan gratuito, considera actualizar a un plan de pago por uso que ofrezca una cuota más alta para no tener errores de la API de OpenAI.

- Si necesitas un aumento de cuota, puedes solicitarlo y proporcionar detalles relevantes sobre el uso esperado. Revisaremos tu solicitud y te responderemos en ~7-10 días hábiles.

429 - The engine is currently overloaded, please try again later

Otro de los errores de la API de OpenAI que indica que nuestros servidores están experimentando un alto tráfico y no pueden procesar tu solicitud en este momento. Esto podría suceder por varias razones, como:

- Hay un aumento repentino o una oleada en la demanda de nuestros servicios

- Hay mantenimiento programado o no programado o una actualización en nuestros servidores

- Hay una interrupción o incidente inesperado e inevitable en nuestros servidores

Para resolver este error, por favor sigue estos pasos:- Vuelve a intentar tu solicitud después de una breve espera. Recomendamos usar una estrategia de espera exponencial o una lógica de reintentos que respete las cabeceras de respuesta y el límite de velocidad. Puedes leer más sobre nuestras mejores prácticas de límite de velocidad

- Revisa la página de estado para cualquier actualización o anuncio sobre servicios y servidores

- Si aún estás recibiendo este error después de un tiempo razonable, por favor contáctanos para obtener más ayuda. Nos disculpamos por cualquier inconveniente y agradecemos tu paciencia y comprensión.

Tipos de Errores de la API de OpenAI de librerías Python

APIError 

Un `APIError` indica que algo salió mal en los servidores de OpenAI lado al procesar tu solicitud. Otro de los errores de la API de OpenAI que podría deberse a un error temporal, un error de programación o una interrupción del sistema. Puedes verificar la página de estado del sistema para obtener más información.

Si encuentras un `APIError`, por favor intenta los siguientes pasos:

1. Espera unos segundos y vuelve a intentar tu solicitud. A veces, el problema puede resolverse rápidamente y tu solicitud puede tener éxito en el segundo intento

2. Revisa nuestra página de estado para ver si hay incidentes o mantenimiento en curso que puedan afectar nuestros servicios. Si hay un incidente activo, sigue las actualizaciones y espera hasta que se resuelva antes de volver a intentar tu solicitud

3. Si el problema persiste, revisa la sección de pasos siguientes para errores persistentes.

Timeout

Un error de `Timeout` indica que tu solicitud tardó demasiado en completarse y nuestro servidor cerró la conexión. Esto podría deberse a un problema de red, una carga pesada en nuestros servicios o una solicitud compleja que requiere más tiempo de procesamiento

Si encuentras un error de `Timeout`, por favor intenta los siguientes pasos:

1. Espera unos segundos y vuelve a intentar tu solicitud. A veces, la congestión de la red o la carga en nuestros servicios pueden reducirse y tu solicitud puede tener éxito en el segundo intento

2. Revisa tu configuración de red y asegúrate de tener una conexión a internet estable y rápida. Es posible que necesites cambiar a una red diferente, usar una conexión por cable o reducir el número de dispositivos o aplicaciones que usan tu ancho de banda

3. Si el problema persiste, revisa la sección de pasos siguientes para errores persistentes

RateLimitError

Otro de los errores de la API de OpenAI es el de `RateLimitError`, que indica que has alcanzado tu límite de tasa asignado. Esto significa que has enviado demasiados tokens o solicitudes en un período de tiempo determinado, y nuestros servicios te han bloqueado temporalmente para enviar más

Imponemos límites de tasa para garantizar el uso justo y eficiente de nuestros recursos y para evitar el abuso o la sobrecarga de nuestros servicios

Si encuentras un error de `RateLimitError`, por favor intenta los siguientes pasos:

1. Envía menos tokens o solicitudes o ralentiza. Es posible que necesites reducir la frecuencia o el volumen de tus solicitudes, agrupar tus tokens o implementar una espera exponencial. Puedes leer la guía de límites de tasa para obtener más detalles

2. Espera hasta que se restablezca tu límite de tasa (un minuto) y vuelve a intentar tu solicitud. El mensaje de error debería darte una idea de tu tasa de uso y uso permitido

3. También puedes verificar las estadísticas de uso de tu API desde tu panel de cuenta. Un `APIConnectionError` indica que tu solicitud no pudo llegar a nuestros servidores o establecer una conexión segura. Esto podría deberse a un problema de red, una configuración de proxy, un certificado SSL o una regla de firewall.

APIConnectionError

Si encuentras un APIConnectionError, por favor intenta los siguientes pasos:

1. Revisa tus ajustes de red y asegúrate de tener una conexión a internet estable y rápida. Puede que necesites cambiar a una red diferente, usar una conexión por cable o reducir el número de dispositivos o aplicaciones que usan tu ancho de banda

2. Revisa tu configuración de proxy y asegúrate de que sea compatible con nuestros servicios. Puede que necesites actualizar tus ajustes de proxy, usar un proxy diferente o evitar el proxy por completo

3. Revisa tus certificados SSL y asegúrate de que sean válidos y estén actualizados. Puede que necesites instalar o renovar tus certificados, usar una autoridad de certificación diferente o desactivar la verificación SSL

4. Revisa tus reglas de firewall y asegúrate de que no estén bloqueando o filtrando nuestros servicios. Puede que necesites modificar tus ajustes de firewall

5. Si es apropiado, verifica que tu contenedor tenga los permisos correctos para enviar y recibir tráfico

Si el problema persiste, revisa nuestra sección de pasos siguientes para errores persistentes.

InvalidRequestError

Otro de los errores de la API de OpenAI es el de `InvalidRequestError`, que indica que tu solicitud estaba mal formada o faltaban algunos parámetros requeridos, como un token o una entrada. Esto podría deberse a un error de escritura, un error de formato o un error de lógica en tu código

Si encuentras un InvalidRequestError, por favor intenta los siguientes pasos:

1. Lee cuidadosamente el mensaje de error e identifica el error específico cometido. El mensaje de error debería aconsejarte sobre qué parámetro era inválido o faltaba, y qué valor o formato se esperaba

2. Revisa la Referencia de API para el método de API específico que estabas llamando y asegúrate de que estás enviando parámetros válidos y completos. Puede que necesites revisar los nombres, tipos, valores y formatos de los parámetros y asegurarte de que coincidan con la documentación

3. Revisa la codificación, formato o tamaño de tus datos de solicitud y asegúrate de que sean compatibles con nuestros servicios. Puede que necesites codificar tus datos en UTF-8, formatear tus datos en JSON o comprimir tus datos si son demasiado grandes

4. Prueba tu solicitud usando una herramienta como Postman o curl y asegúrate de que funcione como se espera. Puede que necesites depurar tu código y corregir cualquier error o inconsistencia en la lógica de tu solicitud

Si el problema persiste, revisa nuestra sección de pasos siguientes para errores persistentes

Un `AuthenticationError` indica que tu clave o token de API era inválido, caducado o revocado. Esto podría deberse a un error de escritura, un error de formato o una violación de seguridad.

AuthenticationError

Si encuentras un AuthenticationError, por favor intenta los siguientes pasos:

1. Revisa tu clave o token de API y asegúrate de que sea correcto y activo. Puede que necesites generar una nueva clave desde el panel de control de API Key, asegurarte de que no haya espacios o caracteres adicionales o usar una clave o token diferente si tienes varios

2. Asegúrate de haber seguido el formato correcto.

ServiceUnavailableError

Cuando te aparece otro de los errores de la API de OpenAI llamado `ServiceUnavailableError`, significa que nuestros servidores no pueden manejar temporalmente tu solicitud. Esto puede ser debido a un mantenimiento planificado o no planificado, una actualización del sistema o una falla del servidor. Estos errores también pueden aparecer durante períodos de alto tráfico

Pedimos disculpas por cualquier inconveniente y estamos trabajando arduamente para restaurar nuestros servicios lo antes posible

Si te encuentras con un `ServiceUnavailableError`, por favor sigue los siguientes pasos:

1. Espera unos minutos y vuelve a intentar tu solicitud. A veces, el problema puede resolverse rápidamente y tu solicitud puede tener éxito en el siguiente intento

2. Revisa nuestra página de estado para ver si hay incidentes o mantenimiento en curso que puedan afectar nuestros servicios. Si hay un incidente activo, por favor sigue las actualizaciones y espera hasta que se resuelva antes de volver a intentar tu solicitud

3. Si el problema persiste, revisa nuestra sección de siguientes pasos para errores persistentes.

Errores persistentes

 Si el problema persiste, contacte al equipo de soporte a través del chat y proporcione la siguiente información:

- El modelo que estaba utilizando

- El mensaje de error y código que recibió

- Los datos de solicitud y encabezados que envió

- La marca de tiempo y zona horaria de su solicitud

- Cualquier otro detalle relevante que pueda ayudarnos a diagnosticar el problema

El equipo de soporte investigará el problema y le responderá lo antes posible. Tenga en cuenta que los tiempos de espera en nuestra cola de soporte pueden ser largos debido a la alta demanda. También puede publicar en el Foro de la Comunidad, pero asegúrese de omitir cualquier información confidencial.