Límites de uso

Los límites mantienen la API rápida para todos. Cuentan las solicitudes en ventanas fijas, por clave y por cuenta.

Límites de solicitudes

Se aplica a	Límite
Cada clave de API	120 solicitudes cada 60 segundos
Todas las claves de una cuenta juntas	300 solicitudes cada 60 segundos

Cabeceras

Cada respuesta a una clave de API incluye el más estricto de los dos límites:

RateLimit-Limit: solicitudes permitidas en la ventana actual.
RateLimit-Remaining: solicitudes que quedan en la ventana actual.
RateLimit-Reset: segundos hasta que se reinicia la ventana.
RateLimit-Policy: el límite y la ventana, por ejemplo 120;w=60.

Por encima del límite recibes 429 con el código rate_limited y una cabecera Retry-After: espera esos segundos antes de reintentar.

HTTP

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 17
RateLimit-Policy: 120;w=60
Retry-After: 17

Generaciones simultáneas

Aparte de los límites de solicitudes, se ejecutan 4 generaciones a la vez por cuenta (8 después de tu primera compra de monedas). Puedes enviar más: las generaciones extra esperan en la cola y empiezan cuando terminan otras. GET /v1/generations/concurrency muestra el límite y cuántas se ejecutan o esperan ahora mismo.

No consultes una generación más a menudo que cada 2 segundos, o usa webhooks.