# Límites de solicitudes y concurrencia

Límites de solicitudes, límites de tareas y cómo gestionar 429.

Fuente: https://scifig.ai/es/docs/api/rate-limits

## Límites

| Límite | Valor | Se aplica a |
| --- | --- | --- |
| Solicitudes de creación | 20 por minuto | Cada clave API o cada cliente OAuth y cuenta, en todos los puntos de acceso `POST` |
| Solicitudes de creación | 40 por minuto | Cada cuenta, entre todas sus credenciales |
| Solicitudes de lectura | 120 por minuto | Cada clave API o cada cliente OAuth y cuenta |
| Tareas en ejecución | Según el plan; consulta `GET /credits` | Cada cuenta, compartido con el sitio web |
| Tareas por hora | 200 por hora móvil | Cada cuenta, compartido con el sitio web |
| Conversiones ráster | 200 al día | Cada cuenta |
| Detecciones de texto | 20 cada 15 minutos | Cada cuenta, compartido con el sitio web |
| Espera limitada | 30 segundos | Cada solicitud |

## Gestión de 429

- Las respuestas a solicitudes que superan la autenticación y la comprobación de ámbito incluyen `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` para la ventana de solicitudes más restrictiva. `401` y `403 SCOPE_DENIED` no los incluyen. Una respuesta `429` incluye `Retry-After` en segundos.
- `429 CONCURRENCY_LIMITED` significa que ya hay demasiadas tareas en ejecución para la cuenta; las terminadas dejan de contar. Las causas de `429 RATE_LIMITED` se enumeran más abajo.
- Espera al menos `Retry-After`, aumenta el intervalo de forma exponencial con variación aleatoria y vuelve a intentarlo con el mismo `Idempotency-Key`.
- Los límites de tareas corresponden a la cuenta: más claves no aumentan la capacidad.

## Causas de una respuesta 429

- Demasiadas solicitudes: 20 solicitudes de creación por minuto y credencial, 40 por cuenta y 120 lecturas por minuto y credencial. `Retry-After` indica el tiempo hasta que se reinicia la ventana; no hay `details.reason`.
- Se han iniciado demasiadas tareas en la última hora: hasta 200 por cuenta, compartidas con el sitio web. `Retry-After: 30`.
- Hay demasiadas tareas en ejecución: `429 CONCURRENCY_LIMITED`, según el plan y compartidas con el sitio web; consulta `GET /credits`. `Retry-After: 30`.
- Se ha agotado el cupo diario de 200 conversiones gratuitas a PNG, PDF, TIFF y PPTX: `details.reason = DAILY_CONVERSION_LIMIT`, con `Retry-After` hasta que se reinicia la ventana diaria.
- Las subidas son demasiado rápidas: `details.reason = UPLOAD_RATE_LIMITED` para imágenes y máscaras en `POST /files`, archivos adjuntos de diagramas de flujo y datos de gráficos. Se aplica el límite de subidas por minuto del sitio web.
- Demasiadas subidas en un día: `details.reason = UPLOAD_DAILY_LIMIT_REACHED` para archivos adjuntos de diagramas de flujo y datos de gráficos. Se aplica el límite diario de subidas del sitio web.
- Detecciones de texto: 20 cada 15 minutos por cuenta, compartidas con el sitio web.