Preços e cobrança
Todo o uso da API é pago a partir de um único saldo de GeraiPoints (GP). Sem assinatura nem cota mensal: você só paga pelos tokens que realmente usar.
GeraiPoints
- Recarregue o saldo na página Recarregar. O saldo não expira.
- O histórico de uso por requisição e por chave fica no Painel.
Como o custo é calculado
O custo de cada requisição é calculado a partir do usage informado pelo modelo, usando a tarifa por 1 milhão de tokens desse modelo, e arredondado para cima até o GP inteiro mais próximo.
biaya = ceil(
input_tokens / 1000000 × tarif_input
+ output_tokens / 1000000 × tarif_output
+ cache_read_tokens / 1000000 × tarif_cache_read
+ cache_write_tokens / 1000000 × tarif_cache_write
)
tagihan = max(biaya, minimum_per_request)Exemplo com a tarifa atual de claude-sonnet-5:
| Componente | Valor |
|---|---|
| Tarifa de entrada | 2.300 GP / 1M token |
| Tarifa de saída | 11.600 GP / 1M token |
| Mínimo por requisição | 50 GP |
| Uso (exemplo) | 20.000 input + 1.000 output |
| Valor cobrado | 58 GP |
Os números vêm do catálogo atual e podem mudar; a tarifa oficial de cada modelo está na página de preços.
Por token ou por requisição?
Todos os modelos são cobrados por token, com um pequeno mínimo por requisição. A exceção é quando há uma promoção de tarifa fixa ativa: os modelos marcados com a promoção são cobrados por um valor fixo por requisição igual ao mínimo, independentemente do número de tokens.
Preços de cache
Modelos com suporte a prompt caching têm uma tarifa separada para tokens lidos do cache (cache read) e, em alguns modelos, para tokens gravados no cache (cache write). Tokens de cache read são bem mais baratos que a entrada normal, então manter o mesmo prefixo de prompt (system prompt, conteúdo de arquivos) economiza custos. A tarifa de cache de cada modelo está na página de preços.
Mínimo por requisição e verificação de saldo
Cada modelo tem um mínimo por requisição (piso). Requisições pequenas cujo custo em tokens fica abaixo do piso são cobradas pelo valor do piso — não é uma taxa adicional sobre o custo dos tokens.
- Antes de encaminhar a requisição, o servidor verifica o saldo e reserva o custo estimado. Se o saldo não for suficiente, responde 402
insufficient_quotasem nenhuma cobrança. - O desconto final é calculado depois que a resposta termina de ser enviada, com base no uso real.
Requisições canceladas
Solicitações canceladas do lado do comprador (timeout do aplicativo, botão de parar, conexão caída) antes de a resposta chegar são cobradas conforme o custo efetivamente aplicado pelo servidor de IA, pelas tarifas vigentes do modelo; não são cobradas se o servidor de IA não cobrar. A cobrança inicial pode ser maior, e a diferença volta automaticamente para o saldo. Saída vazia só é compensada por problemas do nosso lado (resposta vazia/erro do servidor, ou nenhuma saída por ≥60 segundos). Vale a partir de 1º de novembro de 2026.
Para não pagar por requisições interrompidas, defina um timeout de pelo menos 300 segundos e ative o stream. Os guias por ferramenta estão em Configurações de ferramentas agênticas.
Quando há cobrança e quando não há
| Situação | Cobrado? |
|---|---|
| Resposta concluída | Sim — conforme o uso |
| Erro do nosso servidor antes de a resposta sair (502/503) | Não |
| Recusada antes do processamento (400/401/402/403/404) | Não |
| Cancelada do seu lado (timeout do app, botão de parar, conexão perdida) | Sim — o uso já realizado |
| Novas tentativas (retry) automáticas | Sim — cada tentativa é uma nova requisição |