Limites et quotas
Les plafonds auxquels chaque requête est confrontée, et les en-têtes qui indiquent votre quota.
En-têtes de limite de débit
Un appel d'optimisation réussi porte X-RateLimit-Limit (le plafond mensuel du COMPTE — toutes les clés du compte en partagent un seul) et X-RateLimit-Remaining (les appels restants au compte ce mois-ci, celui-ci déduit). Ils ne sont envoyés que par les endpoints d'optimisation : le compteur est réservé au moment d'autoriser un calcul, /v1/usage et /v1/health n'ont donc rien à signaler.
| Champ | Type | Description |
|---|---|---|
| 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. |
Limites
- 2,000 pièces par requête (quantité totale, après développement des qty)
- 50 lignes de stock · corps de requête jusqu'à 1 Mo
- include "pdf" : au plus 500 pièces par requête (quantité totale)
- 10 clés actives par compte — elles partagent UN SEUL quota mensuel : les clés séparent les environnements et les intégrations, elles n'augmentent pas l'enveloppe
- 10 Mo de corps de requête sur les deux routes nest susceptibles de porter un dessin (/v1/optimize/nest et /v1/import/nest) ; un fichier source au maximum 4 000 000 de caractères, 8 000 000 par requête
- la concurrence est bornée côté serveur — les calculs s'exécutent un par un derrière une courte file d'attente (environ 8 s) ; un burst au-delà reçoit 429, et une requête refusée n'est jamais facturée. Les endpoints validate sans clé ont en plus un plafond par adresse (429 avec Retry-After) ; avec une clé valide, jamais de limitation de ce type.
Une adresse qui présente plus de 30 clés API inconnues en une minute reçoit 429 pour le reste de cette minute, avant toute vérification de clé. Un compte peut avoir 5 travaux max en queued/running simultanément.
- Idempotency-Key : 8 à 128 caractères parmi A-Z a-z 0-9 _ - ; la clé et la réponse enregistrée sont conservées 24 heures, par compte et par type de clé (test ou production) ; la clé de démo publique ignore cet en-tête
- webhooks : jusqu'à 5 endpoints par compte ; répondez en 10 s, sinon l'envoi est retenté — 8 tentatives sur 24 heures ; le journal des envois est conservé 30 jours
Un moteur est en panne ? La page d’état montre en direct l’état du site, de l’Engine API, du moteur de nesting et du moteur asynchrone max : État du service ↗