Límites y cuotas
Los límites con los que se comprueba cada solicitud y las cabeceras que informan de tu cuota.
Cabeceras de límite de tasa
Una llamada de optimización exitosa incluye X-RateLimit-Limit (el límite mensual de la CUENTA: todas las claves de la cuenta comparten uno) y X-RateLimit-Remaining (las llamadas que le quedan a la cuenta este mes, contando esta). Los envían únicamente los endpoints de optimización: el contador se reserva como parte de la autorización de un cálculo, así que /v1/usage y /v1/health no tienen nada que informar.
| Campo | Tipo | Descripción |
|---|---|---|
| X-RateLimit-Limit | integer | The ACCOUNT's monthly quota, not this key's: api_authorize compares the month's calls summed over EVERY key on the account against the largest monthly_quota frozen onto any of its ACTIVE keys (migrations 049 + 053). It is the same number GET /v1/usage returns as limit. More keys do not add allowance. On an answer to the public demo key (X-CutOptim-Demo: true) it is instead the per-address DAILY demo allowance. |
| X-RateLimit-Remaining | integer | Calls left on the ACCOUNT in the current UTC calendar month AFTER this one — account-wide for the same reason X-RateLimit-Limit is. Sent only on a successful optimize: the counter is reserved as part of authorizing the request, so /v1/usage and /v1/health have nothing to report. On a demo answer: demo calls left today from this address. |
| Retry-After | integer | Sent with 402 and 409 and 429 only. 402: Seconds until the quota resets — i.e. until 00:00 UTC on the 1st of next month. 409: Sent with idempotency_in_progress: seconds to wait before retrying. 429: Seconds to wait before retrying. |
| X-CutOptim-Demo | "true" | Present, with the value true, only on an answer to the public demo key — refusals included. The demo key has no account: its 200s carry one extra warnings line saying so, and the two X-RateLimit-* headers count the per-address daily demo allowance. |
| Idempotency-Replayed | "true" | Present, with the value true, only when this answer is a stored one returned for a repeated Idempotency-Key. The body and the X-RateLimit-* values are those of the first answer. |
Límites
- 2,000 piezas por solicitud (cantidad total, tras la expansión de qty)
- 50 filas de material · cuerpo de la solicitud hasta 1 MB
- include "pdf": como máximo 500 piezas por solicitud (cantidad total)
- 10 claves activas por cuenta — comparten UNA cuota mensual, así que las claves separan entornos e integraciones, no añaden asignación
- 10 MB de cuerpo de la solicitud en las dos rutas nest que pueden llevar un dibujo (/v1/optimize/nest y /v1/import/nest); un archivo source como máximo 4.000.000 de caracteres, 8.000.000 por solicitud
- la concurrencia está acotada en el servidor — los cálculos se ejecutan de uno en uno tras una cola corta (unos 8 s); una ráfaga que la supere recibe 429, y una petición rechazada nunca se cobra. Los endpoints validate sin clave tienen además un tope por dirección (429 con Retry-After); con una clave válida nunca se limita así.
Una dirección que presenta más de 30 claves API desconocidas en un minuto recibe 429 durante el resto de ese minuto, antes de cualquier comprobación de clave. Una cuenta puede tener 5 trabajos max en queued/running a la vez.
- Idempotency-Key: 8–128 caracteres de A-Z a-z 0-9 _ -; la clave y su respuesta guardada se conservan 24 horas, por cuenta y tipo de clave (prueba o producción); la clave demo pública ignora la cabecera
- webhooks: hasta 5 endpoints por cuenta; responda en 10 s o la entrega se reintenta — 8 intentos en 24 horas; el registro de entregas se conserva 30 días
¿Se ha caído un motor? La página de estado muestra en vivo el estado del sitio web, la Engine API, el motor de nesting y el motor asíncrono max: Estado del servicio ↗