Límites y cuotas
Un límite por minuto y una cuota por día, visibles en cada respuesta.
Cada key tiene dos límites:
- Pedidos por minuto, en una ventana móvil.
- Tokens del modelo por día, que se renuevan a las 00:00 UTC. La cuota se revisa antes de cada pedido: un pedido que empieza dentro de la cuota termina, aunque la pase.
Los límites de tu key dependen de tu plan. Mira los precios, o habla con ventas si necesitas más.
Encabezados
Cada respuesta trae:
| Encabezado | |
|---|---|
X-RateLimit-Limit | Pedidos permitidos por minuto. |
X-RateLimit-Remaining | Pedidos que quedan en la ventana actual. |
X-Request-Id | El id del pedido. |
Retry-After | En 429 rate_limited: segundos a esperar. |
Cuando llegas a un límite
code | Qué pasó | Qué hacer |
|---|---|---|
rate_limited | Demasiados pedidos en este minuto. | Espera Retry-After segundos. Los SDKs lo hacen por ti. |
quota_exceeded | Se usó la cuota diaria de tokens. | Espera a las 00:00 UTC, o sube tu cuota. No se reintenta. |
Revisa tu uso
const usage = await ts.usage();
console.log(usage.today.remaining_tokens, usage.limits.requests_per_minute);Mira GET /v1/usage.