Estimativa de custo da API Gemini 4 Carbon para diagnóstico de incidentes
Um método reproduzível para estimar os custos de cargas de trabalho do Gemini 4 Carbon durante incidentes de API, incluindo novas tentativas, entrada em cache, saída gerada, cobranças por ferramentas e sinais observáveis de falha.
Resumo · TL;DR
A forma confiável de estimar o custo de uma tarefa do Gemini 4 Carbon é criar um registro de tentativas e etapas de continuação sem sobreposição. Registre a entrada comum, a entrada efetivamente atendida pelo cache, os tokens gerados, incluindo thinking quando o contrato aplicável os contabilizar em conjunto, e as ferramentas cobradas separadamente. Em seguida, aplique um período de preços claramente identificado e investigue sinais observáveis de falha, como timeouts, novas tentativas, ausência de dados de uso e crescimento inesperado do contexto.
Principais pontos
- Use USD por 1 milhão de tokens de forma consistente ao comparar os preços oficiais e da OneMux.
- Uma solicitação que falhou ou sofreu timeout ainda pode ter consumido recursos faturáveis; dados de uso ausentes representam um valor desconhecido, não zero.
- Aplique a tarifa de entrada em cache somente quando o provedor informar que houve hits de cache e a rota oferecer suporte a esse preço.
- Registre novas tentativas e turnos de agente em linhas separadas, a menos que um registro de uso do provedor já os inclua.
- Para diagnosticar incidentes, correlacione mudanças de custo com IDs de solicitação, número de tentativas, latência, códigos de status, uso de tokens e quantidades de hits de cache.
Nesta página (8)
A primeira decisão
Durante um incidente de API, a pergunta útil raramente é “Quanto custa uma resposta?”. Geralmente, é: O incidente aumentou o custo de concluir uma tarefa aceita e esse aumento pode ser explicado pelo comportamento observável das solicitações?
Para o Gemini 4 Carbon, estime a resposta a partir de um registro de solicitações. Conte cada tentativa ou etapa de continuação cobrada de forma independente e, em seguida, separe as categorias de tokens e as cobranças por ferramentas. Isso evita atribuir todo o custo à resposta final bem-sucedida.
A OneMux é a editora deste guia e oferece acesso aos principais modelos de IA por meio de uma única API compatível com OpenAI. Os valores da OneMux abaixo são um retrato do catálogo em uma data específica, não uma fatura atual nem um benchmark.
Retrato dos preços e unidades de cobrança
A fonte oficial de preços fornecida apresenta as tarifas Google Standard em USD por 1 milhão de tokens. Os valores do catálogo da OneMux a seguir são apresentados na mesma base, por milhão de tokens, para comparação.
| Fonte da tarifa | Entrada | Saída | Proporção publicada | Data ou período |
|---|---|---|---|---|
| Google Standard | $2.00 / 1M tokens | $10.00 / 1M tokens | Não aplicável | Até 30 de novembro de 2026 |
| Google Standard | $4.00 / 1M tokens | $20.00 / 1M tokens | Não aplicável | A partir de 1º de dezembro de 2026 |
| Catálogo OneMux | $0.312 / 1M tokens | $1.56 / 1M tokens | 0.156 | Capturado em 15 de novembro de 2026 |
O catálogo da OneMux não apresenta, nos dados fornecidos, um preço de entrada em cache nem uma tabela de faixas específica para o Carbon. Não trate valores ausentes como zero e não aplique o preço de entrada comum aos hits de cache, a menos que os termos de cobrança aplicáveis da OneMux indiquem que isso está correto. As condições de faixa, cache e período podem ser diferentes; consulte a página do modelo Gemini 4 Carbon e os preços da OneMux antes de usar a estimativa para aprovação de orçamento.
A fonte oficial das tarifas do Google e das premissas usadas em seus exemplos é Gemini 4 Carbon API Pricing: Calculate the Cost of a Complete Task. O uso apresentado no exemplo é sintético, não uma execução medida do modelo nem uma fatura do provedor.
Um registro associado aos sinais do incidente
Crie uma linha por tentativa ou etapa de agente sem sobreposição. Registre:
- O total de tokens de entrada processados nessa linha.
- A parcela que efetivamente recebeu tratamento de entrada em cache.
- Os tokens gerados, incluindo thinking quando o contrato de uso aplicável informar uma única quantidade faturável combinada.
- Uma cobrança separada conhecida por ferramenta.
- Um ID exclusivo de solicitação ou tentativa.
- Status, latência, informações de timeout e o horário do incidente em um registro operacional separado.
A fórmula de custo é:
ordinary input = total input - cached input
row cost = (ordinary input * ordinary input price
+ cached input * cached input price
+ generated tokens * output price) / 1,000,000
+ separate tool charges
workload cost = sum of every non-overlapping row
Não some a saída visível e thinking quando a quantidade de saída informada já incluir ambos. Se a relação não estiver clara, marque a estimativa como incompleta em vez de escolher a interpretação mais barata.
Exemplo reproduzível
Suponha que uma tentativa aceita tenha 50.000 tokens de entrada, incluindo 40.000 hits de cache efetivos, 6.000 tokens gerados combinados e nenhuma ferramenta cobrada separadamente. Com a tarifa do Google vigente até 30 de novembro de 2026:
- Entrada comum:
10,000 × $2 / 1,000,000 = $0.020 - Entrada em cache:
40,000 × $0.10 / 1,000,000 = $0.004 - Tokens gerados:
6,000 × $10 / 1,000,000 = $0.060 - Total: $0.084
As mesmas quantidades, com as tarifas de dezembro informadas, resultam em $0.168. Esse valor é exatamente o dobro do custo dos tokens, pois as três tarifas de tokens listadas dobram. Uma cobrança separada por ferramenta não dobraria automaticamente; uma cobrança conhecida de $0.01 levaria os totais a $0.094 e $0.178.
Para um cálculo local, preserve os valores decimais e evite arredondar cada linha para centavos:
from decimal import Decimal
input_tokens = Decimal("50000")
cached_tokens = Decimal("40000")
generated_tokens = Decimal("6000")
input_price = Decimal("2")
cached_price = Decimal("0.10")
output_price = Decimal("10")
tool_charges = Decimal("0")
ordinary_tokens = input_tokens - cached_tokens
cost = (
ordinary_tokens * input_price
+ cached_tokens * cached_price
+ generated_tokens * output_price
) / Decimal("1000000") + tool_charges
print(cost) # 0.084
Este é um cálculo ilustrativo. Ele não prevê o consumo de tokens, o comportamento do cache nem a taxa de aceitação do Carbon para um prompt específico.
Diagnostique o incidente antes de alterar o orçamento
Compare um período normal com o período do incidente usando os mesmos campos:
| Sinal observável | O que pode explicar | Pergunta sobre custo |
|---|---|---|
| Mais tentativas por tarefa aceita | Novas tentativas, decisões de fallback ou timeouts do cliente | Cada tentativa recebeu um registro de uso? |
| Aumento dos tokens de entrada | Histórico retido mais longo, resultados de ferramentas ou contexto duplicado | A entrada é acumulada ou por solicitação? |
| Redução dos tokens com hit de cache | Alterações nos prefixos, no timing ou comportamento de cache não suportado | A rota informa os hits de cache? |
| Mais tokens gerados | Raciocínio mais longo, continuação ou limites de saída alterados | A saída já inclui thinking? |
| Timeouts sem dados de uso | Estado desconhecido da execução no servidor | O provedor consegue reconciliar o uso pelo ID da solicitação? |
| Mais cobranças por ferramentas ou consultas de busca | Atividade separada de ferramentas durante o diagnóstico | A cobrança é por consulta, solicitação ou outra unidade? |
Um timeout não comprova que o uso foi zero. Um erro HTTP não comprova que todas as solicitações foram cobradas. Mantenha os valores desconhecidos claramente identificados como desconhecidos até que o provedor ou gateway forneça um registro de uso.
Novas tentativas merecem linhas próprias. Por exemplo, uma primeira tentativa com 50.000 tokens de entrada sem cache e 5.000 tokens gerados custa $0.150 com as tarifas atuais do Google. Somando a tentativa aceita de $0.084, o total é $0.234. Portanto, considerar apenas a resposta aceita subestima o custo da carga de trabalho.
Limites e controles práticos
Um limite de tokens gerados controla uma resposta, não necessariamente a tarefa inteira. Etapas de agente, histórico retido, resultados de ferramentas, novas tentativas e continuações podem aumentar o custo. Use um número máximo de etapas, um limite de gasto por tarefa e uma política explícita de novas tentativas. Verifique o limite entre as etapas, reconhecendo que uma solicitação em andamento pode não parar imediatamente.
Na OneMux, a compatibilidade com um formato de solicitação compatível com OpenAI depende do endpoint documentado e dos parâmetros suportados. Confirme como a rota escolhida informa uso, hits de cache, cobranças por ferramentas e erros antes de considerar seus registros equivalentes a um objeto de uso do Google. A integração com a OneMux não foi testada para este artigo.
Conclusão
Uma estimativa fundamentada para o Gemini 4 Carbon é um exercício de contabilização vinculado ao comportamento observável das solicitações. Escolha o período de preços, normalize o uso, separe os hits de cache, conte as novas tentativas uma única vez e mantenha as cobranças desconhecidas como desconhecidas. Durante um incidente, a comparação mais útil não é o preço de uma resposta bem-sucedida, mas o custo por tarefa aceita antes e depois do surgimento dos sinais de falha.
Retrato dos preços publicados
Capturado em 2026-11-15T09:30:05.411Z do catálogo publicado da OneMux. Os preços mantêm as unidades de cobrança do site; isto não é um benchmark atualizado. A cobrança por faixa, cache ou período pode ser diferente. Valores desconhecidos não são zero.
| Modelo | Entrada oficial | Saída oficial | Entrada OneMux | Saída OneMux | Proporção de preço publicada |
|---|---|---|---|---|---|
| Gemini 4 Carbon | 2 | 10 | $0.312 | $1.56 | 0.156 |
Preços atuais da OneMux. Compare os custos de cargas de trabalho somente quando as unidades de entrada, saída e cobrança forem equivalentes; consulte a página de cada modelo para conhecer as condições das faixas.
Perguntas frequentes
Qual é o preço oficial de entrada e saída do Gemini 4 Carbon?
As tarifas Google Standard fornecidas são $2 per 1 million input tokens e $10 per 1 million output tokens até 30 de novembro de 2026. As tarifas informadas a partir de 1º de dezembro de 2026 são $4 e $20, respectivamente. Esses são os períodos publicados pela fonte, não uma fatura atual.
Como o preço do Gemini 4 Carbon na OneMux se compara?
O retrato do catálogo da OneMux capturado em 15 de novembro de 2026 apresenta $0.312 per 1 million input tokens e $1.56 per 1 million output tokens, com uma proporção de preço publicada de 0.156. As condições de faixa, cache e período podem ser diferentes; confirme os termos atuais antes de elaborar um orçamento.
Um timeout deve ser contado como uma nova tentativa cobrada?
Não presuma nenhum dos dois resultados. Um timeout não comprova que o servidor deixou de executar trabalho nem que a solicitação foi cobrada. Reconcilie a tentativa usando os registros de uso do provedor ou gateway e mantenha o valor como desconhecido quando faltarem evidências.
Os tokens em cache reduzem toda a cobrança de entrada?
Não. Somente os tokens de entrada confirmados como hits de cache devem usar a tarifa aplicável de entrada em cache. O restante da entrada usa a tarifa de entrada comum. O catálogo da OneMux fornecido não inclui um preço de entrada em cache específico para o Carbon.
Os tokens de thinking devem ser somados aos tokens de saída?
Somente quando o contrato de uso aplicável confirmar que as quantidades informadas de saída e thinking são quantidades faturáveis separadas. Se o total de tokens gerados informado já incluir thinking, conte-o uma única vez. Se a relação não estiver documentada, marque a estimativa como incerta.
Artigos relacionados
Guides
Custo da API Gemini 4 Carbon: uma estimativa reproduzível para triagem de suporte
Estime o custo de uma tarefa de triagem de suporte ao cliente com Gemini 4 Carbon, considerando premissas explícitas de tokens, contabilização de cache, aprovação humana, novas tentativas e os preços publicados pela OneMux.
Guides
Custos da API Claude Fable 5.2: uma estimativa reproduzível para diagnóstico de incidentes
Estime os custos da API Claude Fable 5.2 para diagnóstico de incidentes com pressupostos explícitos sobre tokens, cenários de repetição e sinais de falha observáveis.
Guides
Custos da API Gemini 4 Carbon para alterações em repositórios: uma estimativa reproduzível
Estime os custos do Gemini 4 Carbon para alterações de código em repositórios e ciclos de verificação por testes, com premissas explícitas de tokens, cache e tráfego.
Guides
Estimativa de custo da API Gemini 4 Carbon para extração com JSON Schema
Uma forma reproduzível de estimar os custos do Gemini 4 Carbon para extração estruturada, incluindo premissas explícitas sobre tokens, comparação de preços, validação de JSON Schema e casos de falha.