Límites de uso

Dos ventanas fijas de un minuto: una por clave, otra por workspace.

Los dos cubos

Cubo	Límite	Ventana	Protege
Por clave de API	600 peticiones	60s	A ti, de que un bucle con fallo consuma el presupuesto de todo el workspace.
Por workspace	1.800 peticiones	60s	A la plataforma, para que diez claves no multipliquen el techo por diez.

Cabeceras

Toda respuesta autenticada por clave lleva el estado del cubo de esa clave.

text

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 583
X-RateLimit-Reset: 41

X-RateLimit-Reset son los segundos que faltan para que la ventana cambie. Lee esos valores y regula tu ritmo; no esperes al 429.

Cuando te pasas

json

HTTP/1.1 429 Too Many Requests
Retry-After: 41

{
  "error": "RATE_LIMITED",
  "message": "Too many requests. Retry after the window resets.",
  "request_id": "req_01J..."
}

Las ventanas son fijas, no deslizantes. Eso significa que el límite es un borde real: 600 peticiones a las 10:00:59 y otras 600 a las 10:01:00 pasan las dos. Te lo decimos en vez de dejar que lo descubras, porque repartir el ritmo sale más barato para ambos que encontrar el borde en producción.

Si nuestro limitador no está disponible

Falla abierto. Un limitador que tumba la API cuando su propio almacén parpadea convierte un problema de capacidad en una caída. Simplemente no verás las cabeceras en esas peticiones.