Gemini 3.8 Flash

Use gemini-3.8-flash no formato nativo do Gemini. A página do modelo inclui o Playground e os preços atuais; o guia de comparação de modelos compara as configurações documentadas com as do Gemini 3.1 Pro.

ID do modelo

Exemplo rápido

curl https://api.seedrouter.ai/v1beta/models/gemini-3.8-flash:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":1024}}'

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.

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-3.8-flash. A especificação da requisição contém 12 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.

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 todos os modelos ou contas. O raciocínio minimal não é compatível. Temperatura, topP, topK e candidateCount não são controles oficiais deste modelo. 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; a API oficial não aceita turnos finais de preenchimento prévio do modelo. Turnos do usuário contendo somente uma resposta de função continuam válidos.

Saída estruturada

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 1024,
    "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. Os esquemas de resposta seguem a mesma regra de exclusão mútua. A seleção de funções fica em toolConfig.functionCallingConfig; allowedFunctionNames exige ANY ou VALIDATED e nomes declarados.

O modelo oferece suporte à chamada de função. 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 e contexto de URL como capacidades do modelo. A documentação do modelo informa suporte a File Search. Recursos existentes de cache e pesquisa de arquivos exigem acesso com as credenciais que atendem à requisição. Computer Use é listado como prévia. 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 e saída somente de texto; confira as restrições oficiais da API antes de combinar Maps com mídia. 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.

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 resolução global de mídia e a resolução por parte são configurações distintas. Agentic Video é compatível por meio de videoMetadata.processingMode: "AGENTIC".

Use JSON nativo para mídia inline ou uma referência de arquivo acessível para mídias maiores. Os limites exatos de formato de arquivo, duração e mídia por requisição continuam sujeitos à documentação oficial de mídia e à verificação online.

As configurações de segurança usam o formato nativo oficial. A omissão mantém os padrões da API Gemini em vigor; configurações fornecidas explicitamente passam sem alterações.

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, 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.

A continuação para saídas mais longas não foi confirmada para o Gemini 3.8 Flash. Não crie um ciclo de continuação apenas porque o esquema genérico de resposta inclui um campo de token.

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. Os tokens de prompt informados no uso de ferramentas também contribuem para a entrada.

Este modelo não tem mudança de preço para contexto longo em 200.000 tokens. Os grupos disponíveis para a conta usam a mesma expressão de preço do modelo e seu próprio multiplicador atual. Consulte a tabela de preços em tempo real.

Flex e Priority são níveis separados de processamento. Flex usa metade das tarifas Standard de entrada, saída e entrada em cache; Priority usa 1,8 vez essas tarifas. As tarifas introdutórias publicadas pelo Google terminam em 31 de dezembro de 2026; confira sempre a tabela atual do SeedRouter em vez de presumir uma tarifa futura. 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, esta integração usa tarifas Standard por token. Cobranças de ferramentas e armazenamento explícito de cache são separados dos preços dos tokens de geração; nenhuma franquia gratuita compartilhada de ferramentas é prometida. Requisições que falham não são cobradas.

Vários grupos da conta

O modelo usa googlellm e googlellm-vertext, mantendo suas permissões de conta e preços existentes. A grafia de cada nome de grupo é exata. Selecione um grupo disponível no Playground ou use o cabeçalho opcional da API:

X-SeedRouter-Group: googlellm

Use googlellm-vertext para selecionar o segundo grupo. 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-3.8-flash"   -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. Verificações offline de transporte e cobrança não comprovam disponibilidade em produção. A geração online, os dois grupos da conta, a compreensão de mídias, os recursos em cache, as ferramentas integradas e os níveis de processamento ainda exigem verificação paga de ponta a ponta. Não se afirma nenhuma comparação medida de qualidade ou latência com o Gemini 3.1 Pro.

Referências

• Especificação do modelo do Google
• Mudanças do Gemini 3.8
• Referência REST do GenerateContent
• Saída estruturada
• Raciocínio
• Preços