> ## 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.

# Créditos

> Cómo funcionan los créditos de Croma: cuánto cuestan una consulta en vivo y una solicitud a datasets, qué no consume nada, cuándo se reinicia el saldo y cómo es un 402.

Cada organización tiene un plan con un saldo mensual de **créditos**, y cada
solicitud consume créditos según lo que cuesta atenderla:

| Solicitud                                                                                            | Créditos |
| ---------------------------------------------------------------------------------------------------- | -------- |
| [Consulta en vivo](/es/live-lookups): el endpoint consulta la fuente cuando lo llamas                | 10       |
| [Solicitud a datasets](/es/datasets): el endpoint responde desde una copia que Croma mantiene al día | 1        |

Los planes empiezan gratis, sin tarjeta. Qué incluye cada plan y cuánto cuesta
está en la [página de precios](https://usecroma.com/es/pricing).

## Qué no consume nada

* Una respuesta desde caché (`X-Cache: HIT`, o `cache_hit: true` en un
  elemento de un lote), aunque la solicitud necesita créditos suficientes para
  ser aceptada.
* Una solicitud fallida.
* Consultar el estado de un job.

Las [solicitudes en lote](/es/batch) consumen créditos por elemento: un lote
de 10 consultas en vivo consume 100.

## Tu saldo en cada respuesta

Tres encabezados llevan el saldo. `X-RateLimit-Limit` son los créditos que tu
plan otorga cada mes, `X-RateLimit-Remaining` es lo que queda después de esta
solicitud y `X-RateLimit-Reset` es cuándo se renueva el saldo:

```http theme={"dark"}
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4990
X-RateLimit-Reset: 2026-10-01T00:00:00.000Z
```

El saldo se reinicia en la fecha mensual del plan. Administra el plan desde la
[consola](https://platform.usecroma.com/billing). Los contratos tienen su
propio número mensual.

## Cuando se agotan los créditos

Una solicitud que tus créditos restantes no cubren devuelve `402` con un sobre
`billing_error`. Mejora el plan desde la consola o espera el reinicio que
indica `X-RateLimit-Reset`:

```json theme={"dark"}
{
  "error": {
    "type": "billing_error",
    "code": "plan_limit_reached",
    "message": "Your plan has no credits left for this period. Upgrade at https://platform.usecroma.com/billing or wait until 2026-10-01T00:00:00.000Z."
  }
}
```

<Card title="Siguiente: Límites de tasa" icon="gauge" href="/es/rate-limits">
  Los topes por hora de algunos endpoints, todos los encabezados y cómo se comporta un `429`.
</Card>