Límites de tasa
Comprueba cuántas solicitudes y tareas permite tu plan, y qué hacer cuando alcanzas un límite.
Límites por plan
Para mantener la API rápida y disponible para todos, Meshy limita cada cuenta de dos maneras:
- Solicitudes por segundo: cuántas solicitudes de API puedes enviar cada segundo.
- Tareas concurrentes: cuántas de tus tareas pueden estar
PENDINGoIN_PROGRESSal mismo tiempo.
Los límites dependen de tu plan:
| Plan | Solicitudes por segundo | Tareas concurrentes | Prioridad |
|---|---|---|---|
| Pro | 20 | 10 | Predeterminada |
| Premium | 20 | 30 | Más alta que Pro |
| Ultra | 20 | 100 | La más alta |
| Studio | 20 | 60, o 20 en algunos planes Studio anteriores | Más alta que Pro |
| Enterprise | 100 | 100 de forma predeterminada, o un límite personalizado | La más alta |
La prioridad no es un límite. Cuando la cola está ocupada, Meshy inicia primero las tareas con mayor prioridad.
Qué cuenta para cada límite
Toda solicitud de API cuenta para las solicitudes por segundo, incluidas las solicitudes que obtienen, listan o transmiten tareas. Las solicitudes desde la aplicación web de Meshy no cuentan.
El límite de tareas concurrentes cuenta tareas, no solicitudes. Todo endpoint que crea una tarea comprueba este límite antes de crearla. Por ejemplo, Texto a 3D, Imagen a 3D, Multi-imagen a 3D, Retexturizar, Remallado, Rigging, Animación, Texto a imagen, los endpoints de impresión 3D y Creative Lab lo comprueban.
Las solicitudes que no crean una tarea no cuentan para este límite. Por ejemplo, Balance, Uso, y las solicitudes que obtienen, listan o transmiten tareas no cuentan.
A quién se aplican los límites
La siguiente tabla muestra a quién pertenecen los límites que cuentan para tus claves de API, el Playground y la aplicación web:
| Dónde trabajas | Cuenta personal | Equipo |
|---|---|---|
| Claves de API | Tus límites | Los límites del equipo, compartidos por cada clave de API del equipo |
| Playground | Tus límites | Tus propios límites como miembro con sesión iniciada |
| Aplicación web | Tus tareas concurrentes | Tus propias tareas concurrentes. Las tareas que inicia el propietario del equipo también cuentan para los límites del equipo. |
Cuando alcanzas un límite
Cuando superas un límite, la API devuelve 429 Too Many Requests. El mensaje te indica qué límite alcanzaste:
- Demasiadas solicitudes por segundo: el mensaje es
Rate limit exceeded. Espera el número de segundos indicado en el encabezadoRetry-Aftery vuelve a intentarlo. - Demasiadas tareas concurrentes: el mensaje comienza con
NoMorePendingTasks. En un plan ilimitado sin créditos restantes, comienza conNoMoreConcurrentTasks. Este429no tiene encabezadoRetry-After. Espera a que termine una de tus tareas y luego crea la siguiente.
Encabezados de límite de tasa
Las respuestas de la API incluyen estos encabezados para ayudarte a regular el ritmo de tus solicitudes:
| Encabezado | Descripción |
|---|---|
X-RateLimit-Limit | Solicitudes permitidas por segundo en tu plan. |
X-RateLimit-Remaining | Solicitudes restantes en el segundo actual. |
X-RateLimit-Reset | Segundos hasta que tu presupuesto se restablezca por completo. |
Retry-After | Segundos que debes esperar antes de tu próxima solicitud. Se envía con un 429 por exceso de solicitudes por segundo, y al obtener una tarea que sigue PENDING o IN_PROGRESS. |
Cuando Retry-After esté presente, espera esa cantidad de segundos antes de enviar la siguiente solicitud.