Límites de uso

La API limita el número de peticiones por cuenta y por token para garantizar un servicio estable a todas las cuentas.

Límites

Límite	Se aplica a	Máximo
General	Cada cuenta, en todas las operaciones	1.200 por hora
Por token	Cada token, en todas las operaciones	600 por hora
Trabajos de IA	`POST /jobs`	120 por hora
Consultar trabajos	`GET /jobs/{id}` (no gasta el general)	3.600 por hora
Importar al banco	`POST /assets/imports`	120 por hora

Los contadores se reinician al empezar cada periodo (cada hora en punto).

Cabeceras

Cada respuesta indica el límite más ajustado que le afecta:

Cabecera	Descripción
`RateLimit-Limit`	Peticiones permitidas en el periodo.
`RateLimit-Remaining`	Las que te quedan.
`RateLimit-Reset`	Segundos hasta que el contador se reinicia.

Cabeceras de la respuesta

RateLimit-Limit: 600
RateLimit-Remaining: 587
RateLimit-Reset: 2929

Cuando se supera un límite

La API responde 429 e indica en la cabecera Retry-After cuántos segundos debes esperar antes de volver a intentarlo.

Respuesta · 429

{
  "type": "https://creavibe.app/desarrolladores/api/errores/#rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Too many requests. Wait a moment and try again.",
  "code": "rate_limited"
}

Recomendaciones

Vigila RateLimit-Remaining y reparte las peticiones antes de llegar a 0.
Respeta Retry-After antes de reintentar y espera cada vez más si vuelve a ocurrir.
Consulta los trabajos de IA cada 1 o 2 segundos, o usa un webhook en lugar de consultar.
Pide solo las páginas que necesites y guarda en caché lo que no cambia, como las plantillas o los estilos.