Estime o custo de API por requisição e os excedentes
Num plano que inclui 100.000 chamadas, fazer 125.000 significa 25.000 chamadas de excedente. Digite a mensalidade, o volume incluído, o seu uso e a tarifa extra para ver a cobrança adicional, o total do mês e o custo real de uma chamada. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Custo mensal do plano
- 100
- Requisições incluídas
- 100.000
- Requisições reais
- 125.000
- Preço por requisição excedente
- 0,0015
- Custo incluído por requisição
- 0,001
- Requisições excedentes
- 25.000
- Custo do excedente
- 37,5
- Custo mensal total
- 137,5
Este estimador combina o preço mensal recorrente, a franquia incluída, o volume mensal real e a tarifa excedente do fornecedor. Use-o para comparar níveis, conferir uma fatura de produção ou modelar o tráfego antes da contratação. Os valores não dependem de uma moeda, mas todos os montantes devem usar a mesma.
De uma mensalidade a um custo unitário real
Preços mensais facilitam o orçamento, mas dificultam comparações quando os planos incluem franquias diferentes. Esta calculadora produz duas medidas relacionadas. Essa segunda medida varia com a utilização: um plano fixo pouco usado apresenta custo unitário efetivo maior porque a mesma mensalidade é distribuída entre menos chamadas.
A resposta também repete os dados, informa se a franquia foi ultrapassada e apresenta a fórmula para auditoria. Todos os campos monetários são neutros quanto à moeda. Se você informar dólares, os resultados serão em dólares; se informar reais, serão em reais.
Não misture moedas nem períodos de cobrança. Converta contratos anuais, créditos ou faturas trimestrais em um valor mensal representativo. O cálculo mede apenas cobranças diretas por requisições.
Some esses itens ao custo mensal quando fizerem parte do total fixo real.
Calcule a franquia, os excedentes e a tarifa efetiva
As requisições excedentes são o uso real menos a franquia, com mínimo zero. O custo excedente multiplica essa quantidade pelo preço adicional, e o total mensal soma essa cobrança ao preço do plano. Por fim, o custo efetivo divide o total pelo uso real.
Quando o uso real é zero, a calculadora retorna zero para o valor unitário em vez de dividir por zero, mas mantém visível o custo total. Quando a franquia é zero, a referência unitária incluída também é zero porque não existe unidade incluída, enquanto todas as chamadas reais são contadas como excedentes. A ferramenta rejeita explicitamente franquia negativa, preços ou usos negativos, valores não finitos, contagens inseguras e precisão incompatível.
Use a estimativa para escolher planos e controlar custos mensais
Por outro lado, um nível menor pode parecer econômico até que os excedentes elevem seu total acima do nível seguinte. O estimador revela esse ponto sem fingir que prevê o tráfego. Durante a operação, informe a contagem do mês atual para acompanhar a evolução da tarifa efetiva e estimar a despesa direta caso o período terminasse nesse volume.
As equipes financeira e de engenharia podem usar os mesmos campos em planilhas orçamentárias, análises de fornecedores, rateios internos ou explicações de alertas. Interprete o resultado conforme as regras do fornecedor. Normalize a contagem e a tarifa ou faça estimativas separadas por categoria.
Esta ferramenta estima um plano transparente baseado em requisições; não reproduz um mecanismo de faturamento oculto ou multidimensional.
Casos de uso
Conferir uma fatura mensal do fornecedor
Reconstrua a parte da conta baseada em requisições usando a mensalidade, as chamadas medidas e a tarifa excedente publicada.
Criar alertas de orçamento de uso
Transforme o volume atual em campos consistentes de excedente, custo total e custo unitário efetivo para relatórios.
Perguntas frequentes
Qual é a diferença entre custo incluído e custo efetivo?
O custo incluído divide a mensalidade pelo volume incluído: é o preço unitário se você usar tudo. O custo efetivo divide a conta total do mês pelas chamadas realmente feitas, então sobe quando o plano é pouco usado.
Como as chamadas de excedente são contadas?
É o uso acima do volume incluído, e nunca fica abaixo de zero. Com 125.000 chamadas num plano de 100.000, as 25.000 extras são multiplicadas pela tarifa de excedente e somadas à mensalidade.
Posso misturar moedas ou usar um preço anual?
Não. Todos os valores precisam estar na mesma moeda e no mesmo mês de cobrança. Converta um compromisso anual, créditos ou uma fatura trimestral em um único valor mensal antes de digitar.
Impostos ou custos de transferência de dados entram na conta?
Não. Só os encargos diretos de uso são contados. Impostos, transferência de dados, suporte ou mínimos contratados não são deduzidos; se algum for de fato um custo fixo mensal, some à mensalidade.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/dev/api-cost-per-request-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}'const res = await fetch("https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"monthly_plan_cost": 100,
"included_requests": 100000,
"actual_requests": 125000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/api-cost-per-request-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"monthly_plan_cost": 100,
"included_requests": 100000,
"actual_requests": 125000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"monthly_plan_cost":100,"included_requests":100000,"actual_requests":125000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/api-cost-per-request-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"monthly_plan_cost": 100,
"included_requests": 100000,
"actual_requests": 125000
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.api_cost_per_request_estimate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_value | 1000000000000000 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Uma assinatura de API pode parecer barata até que a despesa seja expressa como custo por requisição realmente processada. Ele informa a referência unitária do plano, as requisições adicionais, a cobrança excedente, o total mensal e o custo efetivo por requisição real. O cálculo é gratuito no navegador; uma chamada automatizada custa US$ 0,002 por requisição bem-sucedida.
Converta uma assinatura mensal de API em um custo unitário útil
O custo por requisição incluída divide a mensalidade pelo volume incluído e mostra o preço nominal quando toda a franquia é consumida. O custo efetivo por requisição divide a conta mensal calculada pelo número de requisições realmente feitas. Ele não deduz impostos, transferência de dados, computação, endpoints premium, tokens, suporte ou compromissos mínimos ausentes da entrada.
Calcule a franquia, os excedentes e a tarifa efetiva
Informe monthly_plan_cost como um valor finito não negativo e included_requests como a franquia inteira não negativa publicada pelo fornecedor. Em actual_requests, informe as requisições observadas no mesmo mês. Se houver cobrança além da franquia, defina overage_price_per_request com a tarifa publicada; o padrão é zero para planos sem cobrança excedente ou quando você deseja apenas analisar a utilização fixa.
Use a estimativa para escolher planos e controlar custos mensais
Antes de contratar uma API, teste cenários de tráfego baixo, esperado e alto. Um plano maior pode oferecer tarifa nominal melhor e ainda custar mais por requisição real quando a demanda fica abaixo da franquia. Fluxos automatizados podem chamar a API determinística por US$ 0,002 por requisição bem-sucedida e obter o mesmo cálculo para entradas idênticas. Alguns arredondam blocos, cobram endpoints separadamente, excluem falhas, reiniciam franquias por conta ou faturam tokens.
Casos de integração
Escolher um nível de assinatura de API
Compare a utilização esperada e a exposição a excedentes antes de contratar uma franquia mensal de requisições.
Perguntas técnicas
Como é calculado o custo efetivo de API por requisição?
A calculadora soma a mensalidade e o custo excedente e divide o total pelas requisições reais. Quando o uso é zero, retorna zero em vez de dividir por zero.
Como é calculado o custo excedente da API?
As requisições acima da franquia são multiplicadas por overage_price_per_request. Um uso igual ou inferior à franquia produz zero requisições e zero custo excedentes.
O que acontece se a franquia incluída for negativa?
A requisição falha com invalid_input porque uma franquia incluída não pode ser negativa.
Posso usar qualquer moeda?
Sim. A calculadora é neutra quanto à moeda, mas monthly_plan_cost e overage_price_per_request devem usar a mesma moeda e o mesmo contexto de cobrança.
Quanto custa esta calculadora?
Você pode executá-la gratuitamente no navegador. Cada requisição automatizada bem-sucedida pela API custa US$ 0,002.