Créditos

Solicitação	Créditos
Consulta ao vivo: o endpoint consulta a fonte quando você o chama	10
Solicitação a datasets: o endpoint responde a partir de uma cópia que a Croma mantém atualizada	1

Solicitação

Créditos

Consulta ao vivo: o endpoint consulta a fonte quando você o chama

Solicitação a datasets: o endpoint responde a partir de uma cópia que a Croma mantém atualizada

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

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

{
  "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."
  }
}

A seguir: Limites de taxa

Os tetos por hora de alguns endpoints, todos os cabeçalhos e como um 429 se comporta.

Primeiros passos

Tipos de solicitação

Países

O que não consome nada

O seu saldo em cada resposta

Quando os créditos se esgotam

A seguir: Limites de taxa

​O que não consome nada

​O seu saldo em cada resposta

​Quando os créditos se esgotam

A seguir: Limites de taxa

O que não consome nada

O seu saldo em cada resposta

Quando os créditos se esgotam