Gemini 4 Carbon

Use gemini-4-carbon no formato nativo do Gemini. A página do modelo inclui o Playground e os preços atuais. O Gemini 4 Carbon usa o mesmo formato de requisição do Gemini 4 Argon; segundo o guia do Google, basta alterar o ID do modelo para passar de um para o outro.

ID do modelo

Exemplo rápido

curl https://api.seedrouter.ai/v1beta/models/gemini-4-carbon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"},"maxOutputTokens":32768}}'

O modelo deve estar na URL. contents é obrigatório. Uma resposta inclui os campos nativos candidates, finishReason e usageMetadata; preserve as partes de conteúdo completas, incluindo thoughtSignature, para o histórico da conversa. Prompts difíceis podem levar vários minutos. Uma requisição sem streaming que dure mais de cerca de 100 segundos pode terminar com HTTP 524 antes da chegada da resposta, então use streamGenerateContent para tarefas longas; os exemplos também definem um tempo limite de 15 minutos no cliente, como o Google recomenda.

Endpoints

A especificação OpenAPI inclui todos os esquemas aninhados de requisição e resposta. Campos opcionais omitidos usam os padrões da API. O SeedRouter encaminha o corpo enviado sem filtrar campos desconhecidos, remover campos não suportados ou validar valores dos parâmetros do modelo. A API Gemini decide se uma requisição é aceita.

Parâmetros da requisição

A URL fixa o modelo como gemini-4-carbon. A especificação da requisição contém 11 campos de nível superior. Os campos são opcionais, salvo indicação de obrigatoriedade; omitir é diferente de JSON null. O JSON arbitrário que aceita valores nulos é preservado onde o esquema oficial o permite.

O cache explícito de contexto (recursos cachedContent e cachedContents) não é compatível com o Gemini 4 Carbon. O cache implícito é ativado por padrão para prompts de pelo menos 4.096 tokens.

Parâmetros de geração

O documento OpenAPI lista tipos aninhados, enums, propriedades obrigatórias e limites documentados para cada mensagem. Os esquemas descrevem parâmetros oficiais; não são uma lista de campos permitidos pelo SeedRouter. Campos e valores fornecidos por quem chama a API são preservados. Um campo aceito pelo esquema não comprova suporte em todas as contas. O raciocínio minimal não é um nível listado. O Google informa que temperature, topP e topK são ignorados neste modelo; candidateCount não é um controle oficial. Se enviados no JSON nativo, eles ainda passam sem alterações para tratamento pela API Gemini. Termine a conversa com conteúdo do usuário; turnos do usuário contendo somente respostas de funções continuam válidos.

Decodificação longa

Uma resposta do Gemini 4 Carbon retorna até 65.536 tokens em streaming e até 32.768 tokens sem streaming. Para ir além, defina maxOutputTokens acima de 65.536 e continue a resposta por conta própria:

1. Envie a requisição. Se a resposta terminar com finishReason: "CONTINUATION", leia candidates[0].continuationToken.
2. Envie novamente a mesma requisição com esse valor no campo de nível superior continuationToken. Não acrescente a saída parcial a contents; o token contém o estado do modelo, incluindo seu raciocínio.
3. Repita até que finishReason seja STOP ou MAX_TOKENS.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

Uma etapa dedicada inteiramente ao raciocínio pode retornar texto vazio com CONTINUATION; isso é progresso normal. Cada etapa reenvia ao modelo seu prompt e tudo o que foi gerado até então, de modo que os tokens de entrada são contados novamente em cada etapa posterior. O SeedRouter cobra cada etapa como uma requisição independente. O modo background no servidor da API Interactions não faz parte deste endpoint.

Saída estruturada

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 32768,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Os campos legados responseSchema e responseJsonSchema não podem ser usados juntos. Ambos exigem responseMimeType: "application/json". O esquema mais recente de responseFormat.text também deve especificar JSON. Use os nomes de enum REST (APPLICATION_JSON e TEXT_PLAIN) nessa mensagem. As requisições passam sem alterações; tipos MIME de mídia e JSON arbitrário de funções não são reescritos.

Funções e ferramentas integradas

Use tools[].functionDeclarations com um nome e parameters ou parametersJsonSchema, não ambos. A seleção de funções fica em toolConfig.functionCallingConfig; allowedFunctionNames exige ANY ou VALIDATED e nomes declarados.

Seu aplicativo executa as funções retornadas e fornece os resultados no próximo turno da conversa. Preserve cada thoughtSignature original, chamada de função e resposta de função. Não arredonde identificadores numéricos ao serializar argumentos opacos de funções.

O Google lista Search, Maps, execução de código, contexto de URL, File Search e Computer Use para este modelo. Os recursos de File Search exigem acesso com as credenciais que atendem à requisição. A configuração nativa de MCP aparece no esquema genérico, mas sua disponibilidade para este modelo não está confirmada. O Google Maps exige entrada somente de texto; confira as restrições oficiais da API antes de combinar Maps com mídia. Com embasamento, o Google conta instruções internas de ferramentas e declarações de funções como tokens de entrada. O Playground não executa suas funções personalizadas.

Entrada multimodal e segurança

Um item de contents[].parts[] contém exatamente um payload: texto, mídia inline, referência de arquivo, chamada/resposta de função ou parte de execução. Ele também pode conter uma assinatura ou metadados de mídia. A entrada aceita texto, imagens, áudio, vídeo e PDFs; a saída é somente texto. O modelo não gera imagens ou áudio e não tem Live API.

Para bytes inline, use inlineData.mimeType e data em base64. Para referências de arquivo, use fileData.mimeType e fileUri. Uma URL sintaticamente válida não comprova que o modelo possa acessá-la. Os metadados de vídeo podem especificar deslocamentos de início/fim e um fps positivo de no máximo 24. A compreensão agêntica de vídeo é selecionada por parte com mediaProcessing: "AGENTIC" ao lado de fileData ou inlineData do vídeo; o processamento estático é o padrão. videoMetadata contém somente startOffset, endOffset e fps.

As configurações de segurança usam o formato nativo oficial e passam pela API sem alterações. No Playground, todas as quatro categorias devem ser definidas como BLOCK_MEDIUM_AND_ABOVE ou um nível mais restritivo; limiares mais baixos estão disponíveis somente pela API.

Respostas JSON e streaming

generateContent retorna JSON nativo. streamGenerateContent?alt=sse emite JSON nativo em eventos SSE data:. Os campos importantes incluem candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId e usageMetadata.

Preserve o conteúdo nativo completo no histórico da conversa. Resumos de raciocínio não são o mesmo que assinaturas de raciocínio. Uma desconexão não comprova que a geração falhou ou terminou; examine o resultado parcial e o registro da conta antes de enviar outra requisição. O uso em streaming é cumulativo, portanto use os contadores mais recentes em vez de somar cada trecho.

Uso e preços

promptTokenCount inclui a entrada em cache. cachedContentTokenCount é cobrado pela tarifa de entrada em cache, em vez de ser cobrado novamente como entrada sem cache. A saída faturável inclui candidatesTokenCount mais thoughtsTokenCount. O Gemini 4 Carbon usa mais tokens de raciocínio por turno que o Gemini 4 Argon, então espere maior uso de saída para o mesmo prompt.

Este modelo não tem mudança de preço por tamanho do contexto. Flex e Priority são níveis separados de processamento. Um resultado informado como Standard não deve sofrer acréscimo de Priority; se uma resposta solicitada como Priority não confirmar seu nível efetivo, aplicam-se as tarifas Standard por token. O embasamento com Google Search e Maps é cobrado por consulta, separadamente dos tokens de geração. Requisições que falham não são cobradas. Consulte a tabela de preços em tempo real.

Grupos da conta

Selecione um grupo disponível no Playground ou use o cabeçalho opcional da API com o nome exato do grupo:

X-SeedRouter-Group: GROUP_NAME

O grupo escolhido determina o preço e a capacidade disponível; uma seleção explícita não muda silenciosamente para outro grupo. Omita o cabeçalho ou use auto para manter o comportamento padrão da chave de API.

Consulte os grupos disponíveis para sua chave de API sem gerar uma resposta:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-carbon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Estado da verificação

Os controles e a documentação seguem o formato nativo oficial. A validação de parâmetros cabe à API Gemini. Nas requisições em produção em 11 de novembro de 2026 (uma tentativa para cada teste), observou-se:

Os níveis de processamento, mediaProcessing: "AGENTIC" e os tokens de continuação precisam de uma nova verificação depois que a versão atual chegar à produção. Não se afirma nenhuma comparação medida de qualidade ou latência com o Gemini 4 Argon.

Referências

• Especificação do modelo do Google
• Novidades do Gemini 4 Carbon
• Decodificação longa com generateContent
• Raciocínio
• Preços
• Referência REST do GenerateContent