# Créditos: um único saldo para toda a API

**Publicado:** 4 de setembro de 2026 | **Autores:** Cristian Correa, Tomás Calle

---

Hoje a cobrança chega à plataforma Croma. Sabemos que mudar a forma de cobrar gera perguntas, então esta entrada explica cada regra e cada número, sem letras miúdas. A ideia que guia tudo: você paga pelo que a API entrega, vê seu saldo a qualquer momento e nunca é pego de surpresa por um limite.

Se você já tem uma organização, não precisa fazer nada. Ela já está no plano Free, com créditos para este mês, e o seu console mostra o saldo a partir de hoje.

## O que muda, em uma frase

Antes, cada organização tinha um teto de 100 requisições por dia, igual para todos. Agora, cada organização tem um saldo mensal de **créditos**, e cada requisição consome créditos de acordo com o custo de atendê-la. O teto diário deixa de existir.

## Como funcionam os créditos

Dois tipos de requisição, um único saldo:

| Requisição | Créditos | O que é |
| --- | --- | --- |
| Live | 10 | Um endpoint de dados por país ou global que consulta a fonte oficial no momento em que você o chama: processos judiciais, registros empresariais, veículos, antecedentes, busca na web, extração. |
| Datasets | 1 | Um endpoint que responde a partir das tabelas da Croma, atualizadas regularmente: contratações públicas, normas, diários oficiais, jurisprudência. O guia de cada um indica isso, e ele responde em milissegundos. |

A diferença de preço reflete a diferença de custo. Uma consulta live à fonte oficial tem um custo real a cada vez; um dataset já está pronto. Com o mesmo saldo, você escolhe a combinação que funciona para você: 500 consultas live, 5.000 consultas a datasets ou qualquer mistura entre as duas.

```mermaid
flowchart TD
  A["Solicitud a la API"] --> B{"Qué endpoint"}
  B -->|"Live: fuente oficial"| C["10 créditos"]
  B -->|"Datasets de Croma"| D["1 crédito"]
  C --> E["Un solo balance por organización"]
  D --> E
  E -->|"Balance agotado"| F["402 hasta el reinicio o el upgrade"]
```

As regras, todas elas:

- Os créditos são renovados na data mensal do seu plano. Os que você não usar não se acumulam.
- Requisições em lote consomem por item: um lote de 10 consultas live consome 100 créditos.
- Uma requisição que falha não consome nada. Uma resposta vinda do cache consome o mesmo que uma nova.
- Consultar o status de um job assíncrono nunca consome créditos.
- Busca na web, extração e research mantêm seus limites por hora. Eles protegem as fontes, não o seu bolso.

## Os planos

Todos os planos incluem o catálogo completo, o servidor MCP e o console. A única diferença é quantos créditos você recebe por mês.

| Plano | Preço | Créditos por mês | Equivale a |
| --- | --- | --- | --- |
| Free | US$ 0 | 5.000 | 500 consultas live ou 5.000 consultas a datasets |
| Hobby | US$ 20 | 20.000 | 2.000 consultas live ou 20.000 consultas a datasets |
| Standard | US$ 99 | 100.000 | 10.000 consultas live ou 100.000 consultas a datasets |
| Contrato | Sob medida | O que combinarmos | Maior volume, faturamento sob medida ou condições próprias |

Nos planos pagos, cada 1.000 créditos custam um dólar. O Free não pede cartão. O upgrade vale na hora, com cobrança proporcional; o downgrade vale no fim do período; cancelar leva um clique no portal de cobrança. Os detalhes estão na [página de preços](/pricing).

## O que você vê em cada resposta

O seu código vê o mesmo número que você. Cada resposta da API traz o saldo nos cabeçalhos, em créditos:

```http
X-RateLimit-Limit: 20000
X-RateLimit-Remaining: 19988
X-RateLimit-Reset: 2026-10-04T04:19:37.174Z
RateLimit-Policy: "credits";q=20000;w=2592000
```

Quando o saldo acaba, a API responde `402` com uma mensagem que diz o que fazer, e volta a responder normalmente assim que você faz upgrade ou chega a renovação:

```json
{
  "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-04T04:19:37.174Z."
  }
}
```

O código de erro e os cabeçalhos estão documentados em [limites de requisições](https://docs.usecroma.com/pt/rate-limits).

## Avisos antes que algo aconteça

Ninguém deveria descobrir um limite em produção. Por isso, os administradores da sua organização recebem um e-mail quando o consumo chega a 80% dos créditos do mês, e outro se eles acabarem. O e-mail diz quanto você já usou, quanto tem e quando o saldo é renovado, com o link direto para o seu console, para você decidir com calma.

## O seu console

Em [platform.usecroma.com/billing](https://platform.usecroma.com/billing) você vê o seu plano, o seu saldo de créditos, a data de renovação e os planos disponíveis. Ali você faz upgrade pelo Stripe, gerencia a forma de pagamento, baixa faturas ou cancela. Só os administradores da organização podem mudar o plano; o resto da equipe vê os mesmos números.

## Contratos

Se o seu volume passa do Standard, se você precisa de faturamento sob medida ou prefere condições próprias, a gente conversa e formaliza tudo em um contrato com o seu próprio número de créditos por mês. Na API e no console, ele aparece exatamente como qualquer outro plano: mesmos cabeçalhos, mesmo saldo, mesmos avisos. Só muda quem envia a fatura.

## Crescemos juntos

Construímos este modelo com uma convicção: que cada centavo que você investe na Croma vire dados que servem a você, e que você consiga ver essa relação com clareza. Começar é grátis, crescer é proporcional e nenhuma decisão é tomada no escuro. Se algo aqui não faz sentido para você, ou se você tem um caso que estas regras não cobrem bem, [fale com a gente](https://cal.com/tomas-calle-croma/15min). Ajustamos com prazer.

---

**Mais novidades:** [Ver todas as entradas do changelog](/pt/changelog/sitemap.md) | [Croma](https://usecroma.com)