Guias
Saldo e uso
Consultar saldo, orçamento e consumo pela própria API.
Extensões da ISC para acompanhar consumo pela própria API. Os valores monetários são strings em micro-BRL: "1500000" equivale a R$ 1,50.
GET /balance
Exige o escopo balance.
cURL
curl https://api.semcensura.ia.br/v1/balance \
-H "Authorization: Bearer $ISC_API_KEY" Resposta
{
"currency": "BRL",
"available": "18450000",
"reserved": "120000",
"debt": "0",
"keyBudget": "5000000",
"keyCommitted": "830000"
}| Campo | Tipo | Descrição |
|---|---|---|
available | micro-BRL | Saldo livre da conta. |
reserved | micro-BRL | Valor reservado por chamadas em andamento. |
debt | micro-BRL | Débito pendente. Enquanto for maior que zero, novas chamadas são recusadas. |
keyBudget | micro-BRL ou null | Orçamento da chave, se definido. |
keyCommitted | micro-BRL | Quanto a chave já consumiu do orçamento. |
GET /usage
Exige o escopo usage. Retorna as últimas 50 chamadas da chave, da mais recente para a mais antiga.
Resposta
{
"currency": "BRL",
"data": [
{
"id": "…",
"modelId": "deepseek-v4.1-flash-fast",
"state": "CAPTURED",
"input": 42,
"cached": 0,
"output": 310,
"chargeBrl": "4120",
"latencyMs": 1840,
"code": null,
"createdAt": "2026-11-19T12:00:00.000Z",
"finishedAt": "2026-11-19T12:00:01.840Z"
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
state | string | PENDING (em andamento), CAPTURED (cobrada), RELEASED (liberada sem custo) ou PENDING_RECONCILIATION (em conciliação). |
input / cached / output | inteiro | Tokens de entrada, de entrada em cache e de saída. |
chargeBrl | micro-BRL ou null | Valor cobrado. |
code | string ou null | Motivo quando a chamada não foi cobrada normalmente. |