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 especificado.

Por qué hay límites

Hemos implementado límites de tasa en nuestra API para ayudar a crear la mejor experiencia para todos. Por eso son importantes:

  • ¡Para mantener nuestro servicio seguro y en buen estado! Piensa en los límites de tasa como porteros amables: se aseguran de que nadie pueda sobrecargar nuestra API con demasiadas solicitudes a la vez. Esto ayuda a proteger nuestro servicio frente a posibles usos indebidos y mantiene todo funcionando sin problemas.

  • Para asegurarnos de que todos reciban su parte justa. Igual que compartir juguetes en un parque infantil, queremos asegurarnos de que todos nuestros usuarios tengan el mismo acceso a la API. Al limitar con cuidado cuántas solicitudes puede hacer cada usuario, garantizamos que nadie tenga que esperar demasiado su turno.

  • Para mantener un rendimiento rápido y fiable. 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 llene 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 maneras:

  • solicitudes por segundo: Este es el número de solicitudes de red que puedes hacer por segundo.
  • tareas en cola: Este es el número de tareas de generación concurrentes que puedes ejecutar en cola en cualquier momento dado.

Las tareas en cola incluyen los endpoints de Texto a 3D, Imagen a 3D, Texto a textura y Remallado. Otros endpoints como Carga y saldo no se incluyen en este límite.

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

Además de los límites de tasa, la prioridad de procesamiento de tareas también afectará a 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
Pro2010Predeterminado
Studio2020Mayor que Pro
Enterprise100Predeterminado en 50, se puede personalizarMáxima

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

  • Incidencia de solicitud: Esto ocurre cuando haces demasiadas solicitudes por segundo. Recibirás una respuesta 429 Too Many Requests con un mensaje RateLimitExceeded.
  • Incidencia de cola: 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.