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

> Como funcionam os créditos da Croma: quanto custam uma consulta ao vivo e uma solicitação a datasets, o que não consome nada, quando o saldo reinicia e como é um 402.

Cada organização tem um plano com um saldo mensal de **créditos**, e cada
solicitação consome créditos conforme o que custa atendê-la:

| Solicitação                                                                                                     | Créditos |
| --------------------------------------------------------------------------------------------------------------- | -------- |
| [Consulta ao vivo](/pt/live-lookups): o endpoint consulta a fonte quando você o chama                           | 10       |
| [Solicitação a datasets](/pt/datasets): o endpoint responde a partir de uma cópia que a Croma mantém atualizada | 1        |

Os planos começam grátis, sem cartão. O que cada plano inclui e quanto custa
está na [página de preços](https://usecroma.com/pt/pricing).

## O que não consome nada

* Uma resposta vinda do cache (`X-Cache: HIT`, ou `cache_hit: true` em um
  elemento de lote), embora a solicitação precise de créditos suficientes para
  ser aceita.
* Uma solicitação que falha.
* Consultar o estado de um job.

As [solicitações em lote](/pt/batch) consomem créditos por elemento: um lote
de 10 consultas ao vivo consome 100.

## O seu saldo em cada resposta

Três cabeçalhos carregam o saldo. `X-RateLimit-Limit` são os créditos que o
seu plano concede por mês, `X-RateLimit-Remaining` é o que sobra depois desta
solicitação e `X-RateLimit-Reset` é quando o saldo se renova:

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

O saldo reinicia na data mensal do plano. Administre o plano no
[console](https://platform.usecroma.com/billing). Os contratos têm o seu
próprio número mensal.

## Quando os créditos se esgotam

Uma solicitação que os seus créditos restantes não cobrem retorna `402` com um
envelope `billing_error`. Faça upgrade no console ou espere o reinício indicado
em `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="A seguir: Limites de taxa" icon="gauge" href="/pt/rate-limits">
  Os tetos por hora de alguns endpoints, todos os cabeçalhos e como um `429` se comporta.
</Card>