
A Gemini 4 Carbon API já está disponível no PoYo com o ID de modelo gemini-4-carbon. Podes chamá-la através do endpoint Chat Completions compatível com a OpenAI ou do formato nativo generateContent da Google, com uma única chave PoYo, a $1.60 por 1M de tokens de entrada e $8.00 por 1M de tokens de saída. Experimenta-a na página do modelo Gemini 4 Carbon antes de escreveres qualquer código.
Esta visão geral explica o que a Google diz que o modelo é, os limites com que tens de contar no teu desenho, o preço no PoYo e na Google, e que pedidos vale a pena encaminhar para o Carbon em vez do Gemini 4 Argon.
O que é o Gemini 4 Carbon?
A Google apresentou o Gemini 4 Carbon a 28 de outubro de 2026 como "o nosso modelo mais forte, com capacidades de cibersegurança e de horizonte longo ao nível do estado da arte". Baseia-se no Gemini 4 Argon, lançado duas semanas antes, e a Google diz que foi "construído para fluxos de trabalho agênticos sustentados": encontrar a causa raiz de bugs e corrigi-los em grandes bases de código, programação multiagente, migrações, trabalho de conhecimento denso e raciocínio científico.
O acesso chegou em dois passos:
| Data | O que aconteceu |
|---|---|
| 28 de outubro de 2026 | A Google anuncia o Gemini 4 Carbon; primeiro acesso para um subconjunto de defensores de cibersegurança através do Fairwind Program |
| 10 de novembro de 2026 | Disponível para todos os programadores pagantes no nível pago da Gemini API (AI Studio) e para o Gemini for business |
| 16 de novembro de 2026 | Pode ser chamado no PoYo como gemini-4-carbon |
A Google refere que algumas capacidades de cibersegurança continuam restritas: os programadores candidatam-se ao Fairwind Program "para obter acesso ao Carbon para cibersegurança de forma contínua". Planeia as funcionalidades de segurança defensiva tendo isso em conta.
Gemini 4 Carbon API num relance
| Item | Valor |
|---|---|
| ID do modelo no PoYo | gemini-4-carbon |
| Código do modelo na Google | gemini-4-carbon (uma única versão estável, sem aliases indicados) |
| Janela de contexto | 1,048,576 tokens, partilhados entre entrada e saída |
| Saída máxima | 65,536 tokens por predefinição (a Google indica até 1M apenas com "long decode") |
| Tipos de entrada | Texto, imagem, áudio, vídeo, PDF |
| Tipo de saída | Texto |
| Data de corte do conhecimento | Março de 2026 |
| Nível gratuito na Google | Nenhum |
| Formatos no PoYo | Chat Completions e Gemini Native (não Responses nem Anthropic Messages) |
A página do modelo da Google apresenta o valor de 1M como um limite unificado de entrada e saída, pelo que um prompt de 1 000 000 de tokens deixa quase nenhum espaço para a resposta. A documentação do PoYo não descreve nenhuma opção de long decode, por isso conta com 64K de saída por resposta no PoYo.
Endpoints e autenticação
Ambos os formatos usam Authorization: Bearer $POYO_API_KEY contra https://api.poyo.ai. As respostas chegam no formato nativo de cada um, sem o invólucro code / data que o PoYo usa nas tarefas de multimédia.
| Formato | Endpoint | Streaming | Campo de saída máxima |
|---|---|---|---|
| OpenAI Chat Completions | POST https://api.poyo.ai/v1/chat/completions | "stream": true (SSE) | max_tokens |
| Gemini Native | POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent | :streamGenerateContent (SSE) | generationConfig.maxOutputTokens |
Usa Chat Completions se já trabalhas com o SDK da OpenAI (define base_url como https://api.poyo.ai/v1). Usa Gemini Native quando precisares de partes inlineData para imagens e outros ficheiros: o esquema Chat Completions do PoYo documenta content como uma string simples. Enviar o modelo para um formato não suportado, como /v1/responses, devolve HTTP 400 com a lista de URIs suportados. As estruturas dos pedidos estão na documentação do Gemini Native.
A Google também indica function calling, structured outputs, níveis de thinking e grounding com a Pesquisa Google para este modelo. Os esquemas publicados do PoYo para estes dois endpoints documentam apenas mensagens, contents / parts, campos de amostragem, generationConfig e safetySettings, por isso consulta a documentação antes de dependeres de qualquer outra coisa.
Preços da Gemini 4 Carbon API: PoYo vs Google
O PoYo fatura por token em créditos (1 crédito = $0.005):
| Medidor (por 1M de tokens) | Preço PoYo | Créditos PoYo | Google, até 30 nov 2026 | Google, a partir de 1 dez 2026 |
|---|---|---|---|---|
| Entrada | $1.60 | 320 | $2.00 | $4.00 |
| Saída (incl. tokens de thinking) | $8.00 | 1,600 | $10.00 | $20.00 |
| Leitura de cache | $0.08 | 16 | $0.10 | $0.20 |
As tarifas do PoYo ficam 20% abaixo dos preços introdutórios de entrada e saída da Google. A página de preços da Google diz que os tokens de thinking estão incluídos na tarifa de saída e que o Carbon suporta apenas caching de contexto implícito. Os preços da Google acima são do nível standard. A Google publica também tarifas de batch, que não fazem parte deste endpoint do PoYo. Os preços do PoYo são os indicados a 16 de novembro de 2026; a página do modelo é a fonte atualizada.
Uma revisão de um repositório de 200K tokens com uma resposta de 8K tokens custa 0.2 × $1.60 + 0.008 × $8.00 = $0.384 (76,8 créditos) no PoYo. Os exemplos completos estão em Preços da Gemini 4 Carbon API.
Que pedidos encaminhar para a Gemini 4 Carbon API
Aqui, os benchmarks só interessam como prova para o encaminhamento. Da tabela publicada pela Google:
| Carga de trabalho | Benchmark | Carbon | Argon | Encaminhar para o Carbon? |
|---|---|---|---|---|
| Programação agêntica no terminal | Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | Sim, para tarefas longas com vários passos |
| Programação agêntica de horizonte longo | SWE-sweep | 9.6% | 4.3% | Sim |
| Recuperação em 256K–1M tokens | GraphWalks (BFS F1) | 96.2% | 84.2% | Sim, quando o prompt é enorme |
| Automação de negócio entre ferramentas | AutomationBench (Zapier) | 53.9% | 51.3% | Diferença pequena; testa ambos |
| Deteção de vulnerabilidades | SEC-bench Pro | 88.2% | 83.4% | Sim, se tiveres acesso ao Fairwind |
| Qualidade dos patches para fragilidades | CWE-bench | 71.0% | 68.0% | Sim |
A mesma tabela coloca o GPT-6 Astra à frente no FrontierSWE 2 (65,5% vs 61,2%) e o Claude Opus 5.5 à frente no OSWorld-2.1 (87,2% vs 81,5%). Para uma comparação a três, vê Gemini 4 Carbon API vs Claude Opus 5.5 vs GPT-6 Astra.
Carbon vs Argon: uma regra de encaminhamento
O Carbon e o Argon têm o mesmo preço de entrada e de saída, no PoYo e na Google. A diferença está nos tokens por tarefa: a Google diz que o Carbon trabalha "usando mais tokens do que o Argon para explorar a fundo, raciocinar em profundidade e executar ciclos de verificação alargados", e que "o Argon continua a ser a escolha ideal para a maioria do trabalho de engenharia de software e de conhecimento". Por isso, envia o trabalho diário de programação e de documentos para gemini-4-argon. Envia a depuração mais difícil, as migrações, a recuperação em milhões de tokens e o trabalho de segurança para gemini-4-carbon. Como ambos usam a mesma estrutura de pedido, a mudança resume-se ao ID do modelo. Os detalhes estão em Gemini 4 Carbon API vs Gemini 4 Argon e no guia da Gemini 4 Argon API.
Início rápido com a Gemini 4 Carbon API
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-4-carbon",
"messages": [
{"role": "system", "content": "You are a senior engineer. Answer with a numbered plan."},
{"role": "user", "content": "Plan a migration of a Flask service from SQLAlchemy 1.4 to 2.0."}
],
"max_tokens": 8192
}'
A resposta está em choices[0].message.content e as contagens de tokens em usage. O mesmo pedido através do SDK da OpenAI, o streaming, a entrada de imagens e o formato nativo estão no guia da Gemini 4 Carbon API. Para ciclos de agentes e programação com contexto longo, vê Gemini 4 Carbon API para agentes de programação.
Perguntas frequentes
Qual é o ID do modelo da Gemini 4 Carbon API?
Usa gemini-4-carbon. Passa-o em "model" para /v1/chat/completions, ou no caminho do URL para /v1beta/models/gemini-4-carbon:generateContent.
Quanto custa a Gemini 4 Carbon API?
No PoYo: $1.60 de entrada, $8.00 de saída e $0.08 de leitura de cache por 1M de tokens (320 / 1600 / 16 créditos). A Google cobra $2.00 / $10.00 / $0.10 até 30 de novembro de 2026 e $4.00 / $20.00 / $0.20 a partir de 1 de dezembro de 2026.
A Gemini 4 Carbon API é compatível com o SDK da OpenAI?
Sim. Define base_url="https://api.poyo.ai/v1", usa a tua chave PoYo e define model="gemini-4-carbon" em chat.completions.create.
Qual é a janela de contexto e a saída máxima do Gemini 4 Carbon?
1 048 576 tokens partilhados entre entrada e saída, com 65 536 tokens de saída por predefinição. As entradas podem ser texto, imagens, áudio, vídeo e PDF; a saída é texto.
Existe um nível gratuito para a Gemini 4 Carbon API?
A página de preços da Google diz que o Gemini 4 Carbon não está disponível no nível gratuito. O PoYo funciona em regime pré-pago com créditos.
Devo usar a Gemini 4 Carbon API ou a Gemini 4 Argon API?
O preço por token é o mesmo; o Carbon gasta mais tokens por tarefa. A Google recomenda o Argon para a maioria do trabalho de engenharia de software e de conhecimento, e o Carbon para as tarefas mais difíceis de horizonte longo, de contexto longo e de segurança.