> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Límites de tasa

> Cómo se agrupan y reportan los cupos de la API de Croma.

## Cupos por organización

Los límites de tasa se aplican **por organización**, no por llave. Cada llave
emitida para la misma organización comparte un cupo, así que agregar llaves no
multiplica tu cuota.

El límite por defecto es de **100 solicitudes por día** por organización.
Algunos endpoints tienen topes más estrictos. Por ejemplo, [Web Search](/es/guides/global/web-search)
está limitado a **10 solicitudes por hora**. La página de cada endpoint indica
su límite.

Las [solicitudes en lote](/es/batch) cuentan como **una solicitud por elemento**:
un lote de 10 elementos consume 10 de tu cuota, igual que 10 llamadas
individuales.

## Cuota en los encabezados de respuesta

El estado del límite de tasa viene como encabezados HTTP en cada respuesta (no
en el cuerpo):

| Encabezado              | Significado                                                                                  |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| `X-RateLimit-Limit`     | Solicitudes permitidas en la ventana actual.                                                 |
| `X-RateLimit-Remaining` | Solicitudes restantes antes de ser limitado.                                                 |
| `X-RateLimit-Reset`     | Marca de tiempo ISO en que se reinicia la ventana.                                           |
| `X-Request-Id`          | Id único de la solicitud (`req_…`); inclúyelo en los reportes de soporte.                    |
| `X-Cache`               | `HIT` o `MISS` en endpoints cacheables. Los aciertos de caché igual cuentan contra tu cuota. |

## Cuando excedes el límite

Las solicitudes que superan la cuota devuelven `429` con un sobre
`rate_limit_error` y un encabezado `Retry-After` (segundos):

```json theme={"dark"}
{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}
```

```
Retry-After: 42
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-05-23T18:00:00.000Z
```

Espera (back off) hasta que transcurra `Retry-After` (o `X-RateLimit-Reset`),
luego reintenta.

<Note>
  El limitador **falla abierto**: si el backend de límite de tasa no está
  disponible por un momento, las solicitudes se dejan pasar y no se emiten
  encabezados `X-RateLimit-*`. No dependas de que los encabezados estén siempre
  presentes.
</Note>

<Card title="Siguiente: Errores" icon="triangle-exclamation" href="/es/errors">
  El sobre de error y cada código de error.
</Card>