Nota do autor: o preço introdutório do Gemini 4 Carbon termina em 30 de novembro. Este artigo ajuda você a refazer as contas antes do prazo e a transformar a camada de integração em uma estrutura em que trocar de modelo exige apenas alterar o ID e o endpoint.
Se a sua operação já está integrada ao Gemini 4 Carbon, os próximos 10 dias merecem atenção. A página para desenvolvedores do Google informa que o preço introdutório do Gemini 4 Carbon vai até 2026-11-30 e, a partir de 2026-12-01, passa para o preço padrão, com os preços unitários de entrada e de saída dobrando. Hoje é 2026-11-20, o preço introdutório ainda não acabou, e ainda dá tempo de ajustar o modelo de custos e o código de integração.
Este não é um artigo para convencer você a trocar de modelo imediatamente. A troca não necessariamente sai mais barata, e os resultados também não são necessariamente equivalentes. Este artigo trata de duas questões mais práticas: primeiro, como recalcular os custos depois que o prazo terminar; segundo, como transformar a camada de invocação em uma estrutura que permita alternar a qualquer momento, para que, na próxima mudança de preço ou de janela de contexto, você só precise alterar o ID do modelo e o endpoint, sem reescrever toda a invocação.
Valor central: ao terminar de ler este artigo, você terá a data-limite exata, dois conjuntos de números — preço introdutório e preço padrão — e os endpoints que deve usar ao migrar para Hydrogen, Neon, Fable ou Astra.

Pontos principais sobre o fim do preço introdutório do Gemini 4 Carbon
Vamos reunir os fatos principais logo de cara. Os números da tabela vêm da página de desenvolvedores do Google e das informações de preço verificadas pela APIYI em 2026-11-20, em dólares por milhão de tokens.
| Ponto | Descrição | Impacto para você |
|---|---|---|
| Data limite do preço introdutório | Até 2026-11-30 |
A fatura de novembro é calculada com o preço introdutório |
| Preço introdutório | Entrada 2, saída 10, leitura de cache 0.10 |
Base atual de custo |
| Preço padrão (a partir de 1º de dezembro) | Entrada 4, saída 20, leitura de cache 0.20 |
Com o mesmo uso, o custo aproximadamente dobra |
| Catálogo atual da APIYI | gemini-4-carbon entrada 2, leitura de cache 0.1, saída 10 |
Alinhado ao preço introdutório; após o término, vale a lista de modelos da plataforma |
| Modelos substitutos | Hydrogen, Neon, Fable, Astra | Endpoints diferentes; não dá para compartilhar o mesmo corpo de requisição |
Como entender os dois preços do Gemini 4 Carbon
A diferença entre o preço introdutório e o preço padrão é bem direta: a entrada sobe de 2 para 4, a saída de 10 para 20 e a leitura de cache de 0.10 para 0.20 — os três itens dobram. Por isso, o custo depois de dezembro será quase “o mesmo uso de novembro multiplicado por 2”. Se o seu comando tiver muitos prefixos reutilizáveis e uma alta taxa de acerto de cache, o aumento absoluto na parte de leitura de cache será menor, mas a proporção também dobra.
É preciso diferenciar especialmente o preço de catálogo da APIYI apiyi.com. Conforme a verificação de 2026-11-20, na plataforma o gemini-4-carbon está marcado com entrada 2, leitura de cache 0.1 e saída 10, o que corresponde ao preço introdutório do Google, não ao preço padrão após 1º de dezembro. Depois do término, a forma como a plataforma ajustar deve seguir a lista de modelos da plataforma naquele momento; não trate o preço de catálogo que você vê agora como garantia para depois de dezembro.
Por que não se prender a um único modelo
Depender de um único modelo traz riscos principalmente em três direções. Primeiro, mudança de preço: o fim do período introdutório e ajustes promocionais alteram diretamente o custo por unidade. Segundo, descontinuação ou renomeação do modelo: o ID antigo de repente fica indisponível e as invocações passam a dar erro em massa. Terceiro, o mesmo modelo pode ter níveis de raciocínio e janelas de contexto diferentes em cada ponto de entrada; parâmetros ajustados em um ponto de entrada podem não funcionar em outro.
Nenhuma dessas três mudanças está sob seu controle, mas o que você controla é a extensão do impacto quando elas acontecem. Se o ID do modelo, o tipo de endpoint e os parâmetros de preço estiverem todos fixos no código de negócio, cada mudança exige alterar código, testar de novo e implantar de novo. Se tudo isso estiver concentrado na configuração da camada de acesso, a mudança passa a ser só alterar uma linha de configuração.

Como recalcular o custo depois que o Gemini 4 Carbon expirar
Use o seu próprio consumo para aplicar os dois conjuntos de preços
Na verdade, para recalcular bastam três números: tokens de entrada por mês, tokens de saída por mês e tokens de leitura de cache por mês. Multiplique cada um pelo preço unitário correspondente e some tudo para chegar ao custo mensal. Vou usar um consumo hipotético para demonstrar: 100M tokens de entrada e 20M tokens de saída por mês, sem considerar cache por enquanto. Esse volume é apenas ilustrativo; substitua pelos valores reais da sua fatura.
| Plano de cobrança | Preço unitário de entrada | Preço unitário de saída | Custo mensal com o consumo hipotético |
|---|---|---|---|
| Preço introdutório do Carbon (até 11-30) | 2 |
10 |
100×2 + 20×10 = 400 dólares |
| Preço padrão do Carbon (a partir de 12-01) | 4 |
20 |
100×4 + 20×20 = 800 dólares |
gemini-4-hydrogen |
1.5 |
7.5 |
100×1.5 + 20×7.5 = 300 dólares |
gemini-4-neon |
3 |
15 |
100×3 + 20×15 = 600 dólares |
claude-fable-5-2 |
8 |
40 |
100×8 + 20×40 = 1600 dólares |
gpt-6.2-astra (primeira faixa) |
8 |
40 |
100×8 + 20×40 = 1600 dólares |
Esta tabela considera apenas o preço unitário, não o desempenho. O Hydrogen tem o menor preço unitário, mas se ele pode substituir o Carbon depende de quanto sua tarefa exige de qualidade de raciocínio e estabilidade de formato. Fable e Astra têm preços mais altos e servem para etapas que exigem alta qualidade e onde você está disposto a pagar pelo resultado, não como solução de redução de custos. Em outras palavras, recalcular serve para você enxergar o custo de cada caminho, e não para presumir que trocar já sai mais barato.
Onde conferir os dados de preço
Os preços do APIYI podem ser conferidos em duas fontes. Uma é a tabela geral de modelos, cuja versão verificada em 2026-11-20 foi atualizada em 2026-11-19 10:59 (UTC+8). A outra é o endpoint de preços api.apiyi.com/api/pricing, versão shell-api-modelmak-v1, em que model_ratio igual a 1 corresponde a entrada de 2 dólares por milhão de tokens, e saída e cache são convertidos por completion_ratio e cache_ratio, respectivamente.
Tomando gemini-4-neon como exemplo, essa versão da tabela geral não traz essa linha, mas o endpoint de preços traz: model_ratio é 1.5, completion_ratio é 5, cache_ratio é 0.05. Convertendo, temos entrada 3, saída 15 e leitura de cache 0.15, o que bate com o preço de tabela do Google. Para orçamento, recomendo usar o endpoint de preços como referência principal e a tabela geral como leitura auxiliar.
gpt-6.2-astra tem cobrança escalonada e é preciso olhar os dois lugares. A tabela geral mostra que a primeira faixa é entrada 8, leitura de cache 0.4 e saída 40, e que acima de 272000 tokens a entrada passa para 16; já o endpoint de preços mostra que, acima de 272000 tokens, a saída é calculada a 60 e a leitura de cache a 0.8. Se suas requisições individuais costumam ter contextos muito longos, essa divisão em faixas afeta bastante o custo e precisa ser estimada separadamente.
💰 Dica para conferir custos: antes e depois do vencimento, consulte uma vez o endpoint de preços e a lista de modelos do APIYI apiyi.com, e coloque os preços unitários na sua configuração de roteamento, em vez de deixá-los fixos em comentários de código. Assim, na conciliação mensal, basta comparar se a configuração e os dados da plataforma estão consistentes.
Comparativo de endpoints para os modelos substitutos do Gemini 4 Carbon
Ao trocar de modelo, confira o endpoint primeiro — não presuma que o corpo da requisição é universal
Este é o passo onde mais gente tropeça. Muitos times acham que basta trocar o campo model, já que “todo mundo usa a interface compatível com OpenAI”, mas alguns modelos têm endpoints recomendados completamente diferentes e campos de corpo distintos. A tabela abaixo organiza os tipos de endpoint recomendados para os modelos substitutos; todas as chamadas passam pela mesma base: https://api.apiyi.com/v1.
| Modelo ID | Endpoint recomendado | Preço entrada / leitura de cache / saída | Atenção na troca |
|---|---|---|---|
gemini-4-carbon |
chat ou gemini nativo | 2 / 0.1 / 10 (prateleira atual) |
Após o vencimento, siga a lista de modelos |
gemini-4-hydrogen |
chat ou gemini nativo | 1.5 / 0.075 / 7.5 |
Mesmo endpoint do Carbon, mudança mínima |
gemini-4-neon |
chat ou gemini nativo | 3 / 0.15 / 15 |
Preço conforme a interface de precificação |
claude-fable-5-2 |
chat ou messages | 8 / 0.2 / 40 |
Recursos nativos ficam mais completos via messages |
claude-fable-5-2-thinking |
chat ou messages | 8 / 0.2 / 40 |
O nível de raciocínio é um ID separado |
gpt-6.2-astra |
recomendado: responses | primeira faixa 8 / 0.4 / 40 |
Acima de 272000 tokens, a cobrança é por faixas |
Além disso, o gemini-4-argon também aparece na tabela geral, com preço de entrada 2, leitura de cache 0.1 e saída 10 — igual ao preço atual de prateleira do Carbon. As informações de endpoint dele não são cobertas pelas referências deste artigo; se você estiver considerando esse modelo, confirme o endpoint recomendado na documentação da plataforma antes de integrar.
Onde ficam as diferenças entre os tipos de endpoint
O endpoint chat é o formato de completion de conversa compatível com OpenAI, cujo corpo tem no centro o model e o array messages — é o tipo padrão da maioria dos SDKs. O endpoint gemini nativo usa a estrutura de requisição própria do Gemini, ideal para cenários que exigem parâmetros nativos (como configurações específicas de raciocínio). O endpoint messages é o formato nativo do Claude: a forma de posicionar o comando de sistema e a estrutura dos blocos de conteúdo são diferentes do chat. O endpoint responses é um formato mais recente da OpenAI, e é por ele que o gpt-6.2-astra é recomendado.
Por isso, uma camada de integração sólida deveria ter um adaptador independente para cada tipo de endpoint: o código de negócio passa apenas “tipo de tarefa + conteúdo” e o adaptador monta o formato correspondente. Para os caminhos e campos específicos de cada endpoint, siga o que está descrito no centro de documentação do APIYI.
🎯 Recomendação técnica: antes de trocar, use a mesma chave API do APIYI apiyi.com para enviar algumas requisições reais de negócio a cada endpoint recomendado dos modelos candidatos, confirme que a estrutura de retorno, o comportamento do nível de raciocínio e o tamanho da janela de contexto atendem ao esperado — e só então altere a configuração de roteamento.

Primeiros passos da camada de acesso alternável do Gemini 4 Carbon
Exemplo mínimo: cliente unificado
Esta seção não traz grandes blocos de código, apenas a configuração principal. Ao inicializar o cliente com o SDK compatível com OpenAI, você só precisa de dois parâmetros: client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1"). Depois, ao chamar o endpoint de chat, use client.chat.completions.create(model="gemini-4-carbon", messages=msgs). Para alternar para o Hydrogen, basta mudar model para gemini-4-hydrogen, porque os dois compartilham o endpoint de chat e o corpo da requisição não precisa ser alterado.
Ao alternar para gpt-6.2-astra, a situação é diferente. A forma recomendada é client.responses.create(model="gpt-6.2-astra", input=msgs): o nome do parâmetro muda de messages para input, e a estrutura de retorno também é diferente. É exatamente por isso que a camada de acesso precisa dividir adaptadores por endpoint, em vez de apenas trocar o nome do modelo.
Passos completos de refatoração
Para transformar uma chamada de modelo único em uma estrutura alternável, siga esta ordem:
- Extraia a configuração de roteamento: crie uma tabela de configuração em que cada linha contenha o nome da tarefa, o ID do modelo, o tipo de endpoint, o preço de entrada, o preço de saída e o preço de leitura de cache. O código de negócio só precisa conhecer o nome da tarefa.
- Escreva adaptadores por endpoint: implemente separadamente os quatro adaptadores
chat, Gemini nativo,messageseresponses. Cada adaptador é responsável por converter a entrada unificada no corpo de requisição correspondente e transformar o valor de retorno em uma estrutura unificada. - Unifique o endereço base e a chave: todos os adaptadores compartilham a mesma
base_urle a mesma chave API; ao alternar modelos, não é necessário criar um novo gerenciamento de chaves. - Adicione uma cadeia de fallback: configure um modelo principal e um modelo reserva para tarefas críticas, por exemplo, usar
gemini-4-carboncomo principal egemini-4-hydrogencomo reserva. Se o principal falhar ou for descontinuado, o sistema usa o reserva automaticamente. - Instrumentação de custos: registre o ID do modelo e o uso de tokens em cada chamada; estime o custo em tempo real usando os preços unitários da tabela de configuração; e compare com a fatura no fim do mês.
Ver campos de exemplo da tabela de configuração de rotas
Uma configuração de rota típica pode incluir estes campos: `task: “summary”`, `model: “gemini-4-carbon”`, `endpoint: “chat”`, `price_in: 2`, `price_out: 10`, `price_cache: 0.1`, `fallback: “gemini-4-hydrogen”`. Depois de 1º de dezembro, você só precisa atualizar `price_in` e `price_out` de acordo com a lista de modelos da plataforma, ou trocar `model` e `endpoint`; o código de negócio não precisa mudar em nada.
Para modelos com preço escalonado como `gpt-6.2-astra`, recomenda-se adicionar também `tier_threshold: 272000` e o campo correspondente ao preço unitário da faixa superior; o módulo de instrumentação de custos determina em qual faixa a requisição se enquadra com base no número de tokens de uma única requisição.
🚀 Comece rápido: se você ainda não tem um ponto de entrada unificado, registre-se primeiro na APIYI apiyi.com para obter uma chave API e créditos de teste gratuitos. Use uma única chave para testar Carbon, Hydrogen, Neon, Fable e Astra de ponta a ponta, e só então decida como configurar o roteamento.
Lista de verificação antes do vencimento
| Item de verificação | Prazo recomendado | Descrição |
|---|---|---|
| Exportar o uso de novembro | Até 11-25 | Obter os números reais de tokens de entrada, saída e leitura de cache |
| Calcular os dois conjuntos de preços | Até 11-26 | Calcular o custo mensal usando o preço de lançamento e o preço padrão, separadamente |
| Testar os modelos candidatos | Até 11-28 | Executar um lote de requisições reais em cada endpoint recomendado |
| Colocar a configuração de rotas em produção | Até 11-30 | Incluir os modelos principal e reserva e os preços unitários na configuração |
| Revisar os preços da plataforma | Após 12-01 | Atualizar os preços unitários conforme a lista de modelos da plataforma |
Perguntas Frequentes (FAQ)
Q1: Até que dia exatamente vale o preço introdutório do Gemini 4 Carbon?
De acordo com a página de desenvolvedores do Google, o preço introdutório vai até 2026-11-30, período em que a entrada custa `2`, a saída `10` e a leitura de cache `0.10` dólares por milhão de tokens. A partir de 2026-12-01 passa para o preço padrão: entrada `4`, saída `20` e leitura de cache `0.20`.
Q2: Quanto vai ficar o preço do Carbon no APIYI depois de dezembro?
No catálogo atual do APIYI, o `gemini-4-carbon` está com entrada `2`, leitura de cache `0.1` e saída `10`, o que corresponde ao preço introdutório. Para o preço após 1º de dezembro, consulte a lista de modelos da plataforma; este artigo não oferece nenhuma garantia sobre o preço de catálogo posterior, e recomendamos conferir diretamente em APIYI apiyi.com depois do vencimento.
Q3: Quanto código preciso alterar para migrar do Carbon para o Hydrogen?
A mudança é mínima. Os dois têm o mesmo endpoint recomendado, tanto chat quanto o nativo do gemini; se você já usa o endpoint chat, basta trocar o campo `model` de `gemini-4-carbon` para `gemini-4-hydrogen`. Ainda assim, recomendamos validar o resultado primeiro com requisições reais: preço unitário menor não significa qualidade de tarefa equivalente.
Q4: Por que não dá para simplesmente trocar o nome do modelo ao migrar para Claude Fable ou GPT Astra?
Porque o endpoint recomendado é diferente. O `claude-fable-5-2` pode usar chat ou messages, e os recursos nativos ficam mais completos via messages; já o `gpt-6.2-astra` recomenda responses, e os parâmetros de requisição e a estrutura de retorno são diferentes do chat. Se você simplesmente troca o nome do modelo, é comum encontrar campos não reconhecidos ou falhas de parsing.
Q5: Onde conferir o preço do Gemini 4 Neon?
Na tabela geral de modelos da versão de 2026-11-19 não existe a linha do Neon, mas ela está presente na interface de preços; convertendo, dá entrada `3`, saída `15` e leitura de cache `0.15`, igual ao preço oficial do Google. Para fazer orçamento, basta usar a interface de preços como referência; o endpoint também é chat ou o nativo do gemini.
Q6: Como comparar rapidamente vários modelos candidatos usando uma única Key?
Recomendamos usar uma plataforma agregadora de API para testar de forma unificada:
1. Cadastre-se em APIYI apiyi.com e obtenha a chave API e a cota gratuita de testes
2. Defina o `base_url` do cliente para o endereço unificado e chame cada modelo no endpoint recomendado
3. Registre o consumo de tokens e a qualidade de saída de cada modelo e depois aplique na tabela de recálculo deste artigo
Q7: Quais são as limitações dessa camada de acesso comutável?
A camada de acesso só reduz o custo de troca, não elimina as diferenças de resultado. Modelos diferentes podem ter entendimento, aderência ao formato e comportamento de nível de raciocínio distintos para o mesmo comando, então ainda é preciso fazer testes de regressão após a troca. Além disso, modelos com preço em faixas (como o Astra acima de `272000` tokens) precisam de estimativa separada, e uma fórmula de custo unificada vai subestimar requisições de contexto longo.
Principais conclusões sobre o fim do preço de lançamento do Gemini 4 Carbon
- Data de expiração clara: o preço de lançamento vale até 2026-11-30; a partir de 1º de dezembro passa a vigorar o preço padrão
- Custo praticamente dobrado: os três itens — entrada, saída e leitura de cache — têm preço padrão igual ao dobro do preço de lançamento
- Preço de vitrine não é compromisso: o preço atual do Carbon na APIYI corresponde ao preço de lançamento; após a expiração, vale a lista de modelos
- Endpoints diferentes: Hydrogen e Neon usam chat ou gemini, Fable usa chat ou messages, Astra recomenda responses
- Trocar não garante economia: Hydrogen tem preço unitário baixo, Fable e Astra têm preço unitário alto — é preciso avaliar junto com a qualidade dos resultados
- Configuração é a chave: ID do modelo, endpoint e preço unitário entram na configuração de roteamento; o código de negócio só conhece o nome da tarefa
- Entrada unificada facilita a validação: use uma única chave API da APIYI para testar vários modelos candidatos e só então decidir o roteamento
Resumo
O fim do preço de lançamento do Gemini 4 Carbon tem três pontos centrais:
- Primeiro, faça as contas: aplique o preço de lançamento e o preço padrão ao seu consumo real; a partir de dezembro, o custo para o mesmo volume de uso será cerca de duas vezes maior.
- Depois, confira os endpoints: os endpoints recomendados dos modelos substitutos não são iguais; antes de trocar de modelo, confirme os formatos de requisição de chat, gemini, messages e responses.
- Por fim, configure tudo: concentre o ID do modelo, o tipo de endpoint e o preço unitário na configuração de roteamento; na próxima mudança de preço ou de janela de contexto, altere só a configuração, sem mexer no código.
Faltam 10 dias para 30 de novembro — tempo suficiente para exportar seu consumo, recalcular com as duas tabelas de preço e testar os modelos candidatos. Não amarre o negócio a um único modelo com um único preço: deixar a camada de integração com uma porta aberta para troca é a preparação mais segura para a próxima mudança.
Recomendamos usar a APIYI apiyi.com para uma integração unificada, validando resultados e comparando custos entre vários modelos e endpoints com uma única chave API.
📚 Referências
-
Página de desenvolvedores do Google – Notas de preços do Gemini: preço introdutório e preço padrão do Gemini 4 Carbon
- Link:
ai.google.dev - Descrição: data limite do preço introdutório e preço padrão a partir de 1º de dezembro
- Link:
-
Tabela geral de modelos da APIYI: preço unitário de entrada, saída e leitura de cache de cada modelo
- Link:
docs.apiyi.com/models.md - Descrição: versão verificada em 2026-11-20, atualizada em 2026-11-19 10:59 (UTC+8)
- Link:
-
Endpoint de preços da APIYI: preços em tempo real convertidos por multiplicador
- Link:
api.apiyi.com/api/pricing - Descrição: versão
shell-api-modelmak-v1, adequada para leitura programática de preços unitários
- Link:
Autor: Equipe técnica da APIYI
Contato técnico: fale conosco pela página inicial do site da APIYI; os endpoints de cada modelo e as descrições de parâmetros podem ser consultados no centro de documentação
