Límites de tasa

Los límites de tasa son restricciones que nuestra API impone sobre la cantidad de veces que un usuario o cliente puede acceder a nuestros servicios dentro de un período de tiempo específico.

Por qué existen los límites

Hemos implementado límites de tasa en nuestra API para ayudar a crear la mejor experiencia para todos. Aquí está el porqué de su importancia:

  • Para mantener nuestro servicio seguro y estable. Piensa en los límites de tasa como amables guardias de seguridad: se aseguran de que nadie pueda saturar nuestra API con demasiadas solicitudes a la vez. Esto ayuda a proteger nuestro servicio de un posible uso indebido y mantiene todo funcionando sin problemas.

  • Para asegurarnos de que todos reciban su parte justa. Igual que al compartir juguetes en un patio de recreo, queremos asegurarnos de que todos nuestros usuarios tengan igual acceso a la API. Al limitar suavemente cuántas solicitudes puede hacer cada usuario, garantizamos que nadie tenga que esperar demasiado su turno.

  • Para mantener un rendimiento ágil y confiable. Al gestionar el flujo general de solicitudes, podemos mantener tiempos de respuesta rápidos y un servicio estable para todos nuestros maravillosos usuarios. Es como asegurarse de que una autopista no se sature demasiado: el tráfico fluye mejor cuando evitamos la congestión.

Cómo funcionan los límites

Los límites de tasa se miden de 2 formas:

  • Solicitudes por segundo: Es la cantidad de solicitudes de red que puedes hacer por segundo.
  • tareas en cola: Es la cantidad de tareas de generación concurrentes que puedes ejecutar en cola en un momento dado.

Las tareas en cola incluyen los endpoints de Texto a 3D, Imagen a 3D, Texto a textura y Remallado. Otros endpoints como Upload y Balance no están incluidos en este límite.

Los límites se aplican por cuenta. Esto significa que los límites se comparten entre todas tus API keys.

Además de los límites de tasa, la prioridad de procesamiento de tareas también afectará la velocidad de tus tareas.

Cada nivel de usuario tiene límites de tasa y niveles de prioridad específicos diseñados para adaptarse a sus necesidades. Estos son los límites actuales por nivel:

Nivel de usuarioSolicitudes por segundotareas en colaNivel de prioridad
Pro2010Por defecto
Premium2030Mayor que Pro
Ultra20100La más alta
Studio2020Mayor que Pro
Enterprise100100 por defecto, personalizableLa más alta

Si superas estos límites, recibirás una respuesta 429 Too Many Requests de nuestra API. Hay dos tipos de eventos que pueden desencadenar esto, cada uno con una respuesta diferente:

  • Request Hit: Esto ocurre cuando haces demasiadas solicitudes por segundo. Recibirás una respuesta 429 Too Many Requests con un mensaje RateLimitExceeded.
  • Queue Hit: Esto ocurre cuando tienes demasiadas tareas de generación concurrentes en ejecución. Recibirás una respuesta 429 Too Many Requests con un mensaje NoMoreConcurrentTasks.