Text
Gemini 4 Argon
Requisições nativas do Gemini, entradas multimodais, raciocínio, ferramentas, streaming e continuação. Inclui os limites atuais da verificação.
Use gemini-4-argon no formato nativo do Gemini. A página do modelo inclui o Playground e os preços atuais; o guia de lançamento explica a disponibilidade.
ID do modelo
| ID do modelo | Janela de contexto | Nível de raciocínio padrão |
|---|---|---|
gemini-4-argon | 1.048.576 tokens | medium |
Exemplo rápido
curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon: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":256}}'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
| Operação | Endpoint |
|---|---|
| Resposta JSON | POST /v1beta/models/gemini-4-argon:generateContent |
| Eventos enviados pelo servidor | POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse |
A especificação OpenAPI inclui todos os esquemas aninhados de requisição e resposta. Campos opcionais omitidos usam os padrões da API. Campos desconhecidos e oficialmente não suportados são descartados; valores inválidos de campos suportados continuam sendo erros.
Parâmetros
| Nome | Tipo | Obrigatório | Padrão | Observações |
|---|---|---|---|---|
contents | object[] | Sim | — | Array de conversa obrigatório; parts contém texto, mídia e resultados de ferramentas |
systemInstruction | object | Não | — | Instrução do sistema somente em texto |
generationConfig | object | Não | — | Orçamento de saída, raciocínio, saída estruturada, configurações de parada e mídia |
tools | object[] | Não | — | Definições de funções e ferramentas integradas |
toolConfig | object | Não | — | Seleção de funções, configurações de recuperação e partes de ferramentas do servidor |
safetySettings | object[] | Não | — | Pares únicos de categoria e limiar |
continuationToken | string | Não | — | Token de continuação opaco do candidato mais recente |
serviceTier | enum | Não | standard | unspecified, standard, flex, priority; standard por padrão |
labels | object | Não | — | Chaves e valores de rótulos em minúsculas, com até 63 caracteres Unicode cada |
store | boolean | Não | — | Preferência de registro de requisições; não permite recuperar conversas armazenadas |
model | string | Não | — | Nome de recurso opcional no corpo; a URL fixa o modelo |
generationConfig inclui maxOutputTokens, thinkingConfig, stopSequences, responseFormat, os campos legados responseMimeType/responseSchema/responseJsonSchema, responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig e audioTranscriptionConfig. Campos genéricos sem comportamento específico do modelo confirmado continuam sujeitos à verificação de capacidades.
- Níveis de raciocínio:
low,medium,high;mediumpor padrão. O raciocínio não pode ser desativado.includeThoughtssolicita resumos. O campo obsoletothinkingBudgeté aceito isoladamente, mas não pode ser combinado comthinkingLevel. - Entrada, raciocínio e saída compartilham 1.048.576 tokens.
maxOutputTokensinclui raciocínio; o contexto restante pode reduzir o orçamento efetivo. - O REST nativo usa um limite e um padrão de saída de 32.768 tokens por requisição, ou de 65.536 em streaming. Saídas mais longas usam continuação. A documentação oficial é contraditória sobre primeiras requisições sem streaming acima de 32.768 tokens; esta integração não impõe esse valor como limite da geração total.
- No máximo cinco
stopSequences.logprobsvaria de 0 a 20 e exigeresponseLogprobs: true. responseSchemaeresponseJsonSchemasão mutuamente exclusivos e exigemresponseMimeType: "application/json". Novas requisições podem usarresponseFormat.text, como mostrado abaixo.responseModalitiessó pode conterTEXT. Temperatura, top-p, top-k e a contagem de candidatos não são controles ativos do Argon.cachedContentexplícito, geração de imagens e geração de fala não são suportados.
Saída estruturada e ferramentas
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 256,
"responseFormat": {
"text": {
"mimeType": "APPLICATION_JSON",
"schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
}
}
}
}As funções usam tools[].functionDeclarations. allowedFunctionNames exige o modo ANY ou VALIDATED e nomes declarados. Preserve chamadas de funções, respostas e assinaturas na ordem original. Google Search, Maps, execução de código, contexto de URL, File Search e Computer Use são capacidades oficiais; acesso a recursos, cobranças e comportamento devem ser verificados para a operação pretendida. O Playground não executa ferramentas localmente.
Mídia e segurança
O campo nativo parts aceita entradas de texto, imagem, áudio, vídeo e PDF por meio de inlineData ou fileData. Cada parte contém uma variante de payload, opcionalmente acompanhada de assinaturas de raciocínio e metadados de mídia. O mediaResolution global e a resolução por parte são distintos. Vídeo oferece suporte ao processamento STATIC e AGENTIC; videoMetadata.fps deve ser maior que zero e no máximo 24.
O Playground aceita uma requisição JSON de até 12 MiB. Esse é um limite de transporte do aplicativo, não o limite de mídia do modelo. Para mídias grandes, use referências de arquivos suportadas pela sua conta. Recursos de arquivos e mídias buscadas externamente têm limites oficiais diferentes; a disponibilidade deles aqui ainda não foi verificada.
As configurações de segurança da API pública seguem a especificação nativa. O Playground exige bloqueio a partir do nível médio para as quatro principais categorias de segurança; limiares mais baixos estão disponíveis somente na API, com uma exceção para administradores.
Streaming e continuação
Leia os eventos JSON nativos do fluxo SSE. Preserve todas as partes, incluindo metadados de ferramentas e raciocínio. Os contadores de uso dentro de um fluxo são cumulativos: use o último objeto de uso em vez de somar cada evento.
Quando um candidato retornar continuationToken, preserve-o exatamente. Para CONTINUATION, reenvie os conteúdos, a instrução do sistema, as ferramentas e as configurações de geração originais com o token mais recente no nível superior. Não acrescente saída parcial a contents. Para MAX_TOKENS, aumente o orçamento de saída antes de retomar. O Playground prepara uma requisição de continuação para revisão e só a envia quando você pressiona Enviar novamente.
Cada continuação é uma requisição separada, com seu próprio uso e sua própria cobrança. Preserve pontos de retomada se implementar reconexões; nunca presuma que um fluxo desconectado foi concluído. A resposta nativa é mantida no Playground para inspecionar todos os campos.
Uso e estado atual da verificação
O uso de entrada inclui a entrada em cache; a saída faturável inclui os tokens de candidatos e raciocínio. Consulte as tarifas atuais na página do modelo e os registros de uso da sua conta. Requisições que falham não são cobradas.
As verificações locais de 14 de outubro de 2026 confirmaram o streaming de texto, o JSON estruturado, as chamadas de funções com assinatura e o retorno dos resultados, a execução de código, Google Search e URL context, a compreensão de imagens, vídeos e PDF, a saída de raciocínio e as sequências de parada. O áudio foi aceito, mas parte da amostra foi transcrita incorretamente.
logprobs foi rejeitado explicitamente. As requisições com maxOutputTokens: 32769 falharam tanto nas verificações JSON quanto nas SSE. Um continuationToken válido e outro inválido retornaram respostas, portanto a continuação correta não foi verificada. As opções de nível de serviço e seed foram aceitas sem comprovação de seu efeito. Maps, File Search, Computer Use, agentic video e as referências a arquivos externos continuam sem testes.
Essas verificações limitadas não validam todas as combinações de parâmetros nem a disponibilidade em produção. Use o formato nativo para a especificação completa; a compatibilidade com OpenAI é um subconjunto separado e não oferece long decode.
Referências
- Especificação oficial do modelo
- Guia de migração do GenerateContent
- Decodificação longa e continuação
- Saídas estruturadas
Grupo LLM opcional
Entre no Playground deste modelo para consultar os grupos disponíveis. As opções dependem das permissões da sua conta e do modelo selecionado. O Playground usa sua sessão de login; você não precisa fornecer uma chave API.
As chamadas de API mantêm sua chave API e o ID do modelo. Para selecionar um grupo, envie o nome exato dele no cabeçalho de requisição opcional X-SeedRouter-Group. Substitua GROUP_NAME abaixo por um nome exibido no Playground. Omita o cabeçalho ou use auto para manter o comportamento padrão da chave.
X-SeedRouter-Group: GROUP_NAMEUma chave API com restrições pode ter menos opções de grupo que o Playground. As requisições usam os preços do grupo selecionado e não mudam para outro grupo se ele estiver indisponível. Esta opção aceita chamadas LLM por HTTP, incluindo SSE; ela não se aplica a chamadas WebSocket, de imagem ou de vídeo.
Para consultar os grupos disponíveis para uma chave API específica sem gerar uma resposta do modelo, use este endpoint somente leitura. data[].id é o valor do cabeçalho; ratio é o multiplicador de preço da conta para esse grupo. A entrada auto reflete a estimativa atual da seleção padrão; seu multiplicador é null quando nenhum grupo padrão está disponível. A disponibilidade do grupo é verificada novamente quando você chama o modelo.
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"