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 porteros: 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 asegurar que todos reciban su parte justa. Al igual que compartir juguetes en un patio de recreo, queremos asegurarnos de que todos nuestros usuarios tengan acceso equitativo a la API. Al limitar suavemente cuántas solicitudes puede hacer cada usuario, garantizamos que nadie tenga que esperar demasiado 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 los atascos!

---

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:

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 realizas demasiadas solicitudes por segundo. Recibirás una respuesta 429 Too Many Requests con un mensaje de Rate limit exceeded.
• 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 NoMorePendingTasks (o, cuando se te agoten los créditos, NoMoreConcurrentTasks). Este 429 no tiene Retry-After: espera a que una de tus tareas termine antes de crear otra.

---

Encabezados de límite de tasa

Las respuestas de la API incluyen estos encabezados para que puedas regular el ritmo de tus solicitudes:

Cuando Retry-After esté presente, espera esa cantidad de segundos antes de enviar la siguiente solicitud.