Límites de uso

Son dos límites distintos

El rate limit es cuántas llamadas por segundo podés hacer. La cuota es cuántas unidades tenés en el período. Se agotan por caminos distintos y devuelven códigos distintos.

Los dos corren por suscripción y por API, no por clave. Podés crear cinco claves para separar tus entornos sin multiplicar ni dividir tu límite.

Qué es una unidad

Cada endpoint tiene un costo en unidades, que sale de su clase de endpoint. Hoy todos los endpoints de Color Utilities pesan 1, así que la consola y las facturas dicen «llamadas». Cuando entren endpoints de costo distinto, el sustantivo pasa a «unidades» en todo el producto a la vez.

En la familia scrapeada un cache MISS puede costar más que un HIT, porque significa ir a buscar el dato al sitio de origen. El costo de MISS está publicado en la ficha de cada endpoint, al lado del costo base.

Cuando te queda menos de una unidad

Si te quedan 1 unidad y llamás a un endpoint que cuesta 8, la llamada se rechaza con 429 quota_exceeded aunque la consola diga «499/500». El mensaje del error dice exactamente lo mismo que la barra de la consola:

{ "code": "quota_exceeded",
  "message": "Te quedan 1 unidad de 500 y esta llamada cuesta 8. Tu cuota se renueva el 14/10/2026.",
  "quota_remaining": 1, "call_cost_units": 8, "quota_reset": 1790380800 }

Plan Básico: nunca te va a llegar una factura sorpresa

El plan Básico no tiene precio de excedente configurado. Al llegar a las 500 del período recibís 429 quota_exceeded y listo: estructuralmente no podemos cobrarte de más aunque quisiéramos. En los planes pagos el excedente está apagado por defecto y se activa desde la consola, con un techo en dólares que define tu peor factura posible.