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é 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é son importantes:

  • ¡Para mantener nuestro servicio seguro y protegido! Piensa en los límites de tasa como porteros amigables: se aseguran de que nadie pueda abrumar nuestra API con demasiadas solicitudes a la vez. Esto ayuda a proteger nuestro servicio de un posible mal uso y mantiene todo funcionando sin problemas.

  • Para asegurarnos de que todos obtengan su parte justa. Al igual que compartir juguetes en un parque infantil, queremos asegurarnos de que todos nuestros usuarios tengan igual acceso a la API. Al limitar suavemente cuántas solicitudes puede hacer cada usuario, nos aseguramos de que nadie tenga que esperar demasiado para su turno.

  • Para mantener el 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 congestione demasiado: el tráfico fluye mejor cuando prevenimos 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 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 del procesamiento de tareas también afectará la velocidad de tus tareas.

Cada nivel de usuario tiene límites de tasa específicos y niveles de prioridad diseñados para satisfacer sus necesidades. Aquí están los límites actuales por nivel:

Nivel de usuarioSolicitudes por segundoTareas en colaNivel de prioridad
Pro2010Predeterminado
Premium2030Más alto que Pro
Ultra20100El más alto
Studio2020Más alto que Pro
Enterprise100Predeterminado a 50, puede ser personalizadoEl más alto

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

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