Gemini 4 Argon

Usa gemini-4-argon nel formato Gemini nativo. La pagina del modello include il Playground e i prezzi attuali; la guida al rilascio spiega la disponibilità.

ID modello

Esempio rapido

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}}'

Il modello va indicato nell’URL. contents è obbligatorio. Una risposta include i campi nativi candidates, finishReason e usageMetadata; conserva le parti di contenuto complete, incluso thoughtSignature, per la cronologia della conversazione.

Endpoint

La specifica OpenAPI include tutti gli schemi annidati di richiesta e risposta. I campi facoltativi omessi usano i valori predefiniti dell’API. I campi sconosciuti e quelli ufficialmente non supportati vengono scartati; i valori non validi dei campi supportati restano errori.

Parametri

generationConfig include maxOutputTokens, thinkingConfig, stopSequences, responseFormat, i campi precedenti responseMimeType/responseSchema/responseJsonSchema, responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig e audioTranscriptionConfig. I campi generici senza un comportamento specifico del modello confermato restano soggetti alla verifica delle capacità.

• Livelli di ragionamento: low, medium, high; medium per impostazione predefinita. Il ragionamento non può essere disattivato. includeThoughts richiede riepiloghi. Il campo deprecato thinkingBudget viene accettato da solo, ma non può essere combinato con thinkingLevel.
• Input, ragionamento e output condividono 1.048.576 token. maxOutputTokens comprende il ragionamento; il contesto rimanente può ridurre il budget effettivo.
• REST nativo usa un limite e un valore predefinito di output di 32.768 token per richiesta, o di 65.536 in streaming. Gli output più lunghi usano la continuazione. La documentazione ufficiale è contraddittoria sulle prime richieste senza streaming oltre 32.768 token; questa integrazione non impone tale valore come limite della generazione totale.
• Al massimo cinque stopSequences. logprobs va da 0 a 20 e richiede responseLogprobs: true.
• responseSchema e responseJsonSchema si escludono a vicenda e richiedono responseMimeType: "application/json". Le nuove richieste possono usare responseFormat.text come mostrato sotto.
• responseModalities può contenere solo TEXT. La temperatura, top-p, top-k e il numero di candidati non sono controlli attivi di Argon. Non sono supportati cachedContent esplicito, generazione di immagini e generazione vocale.

Output strutturato e strumenti

{
  "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"]}
      }
    }
  }
}

Le funzioni usano tools[].functionDeclarations. allowedFunctionNames richiede la modalità ANY o VALIDATED e nomi dichiarati. Conserva le chiamate a funzioni, le risposte e le firme nell’ordine originale. Google Search, Maps, esecuzione di codice, contesto URL, File Search e Computer Use sono capacità ufficiali; accesso alle risorse, costi e comportamento devono essere verificati per l’operazione prevista. Il Playground non esegue gli strumenti localmente.

Contenuti multimediali e sicurezza

Il campo nativo parts accetta input di testo, immagini, audio, video e PDF tramite inlineData o fileData. Una parte contiene una sola variante di payload, eventualmente accompagnata da firme di ragionamento e metadati multimediali. Il mediaResolution globale e la risoluzione per parte sono distinti. Il video supporta l’elaborazione STATIC e AGENTIC; videoMetadata.fps deve essere maggiore di zero e al massimo 24.

Il Playground accetta una richiesta JSON fino a 12 MiB. Si tratta di un limite di trasporto dell’applicazione, non del limite multimediale del modello. Per contenuti multimediali di grandi dimensioni, usa riferimenti a file supportati dal tuo account. Le risorse file e i contenuti multimediali recuperati dall’esterno hanno limiti ufficiali diversi; la loro disponibilità qui non è ancora stata verificata.

Le impostazioni di sicurezza dell’API pubblica seguono la specifica nativa. Il Playground richiede il blocco a partire dal livello medio per le quattro principali categorie di sicurezza; le soglie più basse sono disponibili solo tramite API, con un’eccezione per gli amministratori.

Streaming e continuazione

Leggi gli eventi JSON nativi dal flusso SSE. Conserva tutte le parti, inclusi i metadati degli strumenti e del ragionamento. I contatori di utilizzo all’interno di un flusso sono cumulativi: usa l’ultimo oggetto di utilizzo anziché sommare ogni evento.

Quando un candidato restituisce continuationToken, conservalo esattamente. Per CONTINUATION, invia di nuovo i contenuti, l’istruzione di sistema, gli strumenti e le impostazioni di generazione originali con l’ultimo token al livello principale. Non aggiungere l’output parziale a contents. Per MAX_TOKENS, aumenta il budget di output prima di riprendere. Il Playground prepara una richiesta di continuazione da esaminare e la invia solo quando premi nuovamente Invia.

Ogni continuazione è una richiesta separata con il proprio consumo e il proprio addebito. Conserva punti di ripresa se implementi riconnessioni; non presumere mai che un flusso disconnesso sia stato completato. La risposta nativa viene conservata nel Playground per consentire l’esame di tutti i campi.

Utilizzo e stato attuale delle verifiche

L’utilizzo dell’input comprende l’input in cache; l’output fatturabile comprende i token dei candidati e del ragionamento. Consulta le tariffe attuali nella pagina del modello e i registri di utilizzo del tuo account. Le richieste non riuscite non vengono addebitate.

Le verifiche locali del 14 ottobre 2026 hanno confermato lo streaming di testo, il JSON strutturato, le chiamate a funzioni con firma e la restituzione dei relativi risultati, l’esecuzione di codice, Google Search e URL context, la comprensione di immagini, video e PDF, l’output di ragionamento e le sequenze di arresto. L’audio è stato accettato, ma una parte del campione è stata trascritta in modo errato.

logprobs è stato rifiutato esplicitamente. Le richieste con maxOutputTokens: 32769 sono fallite sia nelle verifiche JSON sia in quelle SSE. Un continuationToken valido e uno non valido hanno entrambi prodotto risposte, quindi la continuazione corretta non è verificata. Le opzioni del livello di servizio e seed sono state accettate senza prove del loro effetto. Maps, File Search, Computer Use, agentic video e i riferimenti a file esterni restano da testare.

Queste verifiche limitate non convalidano tutte le combinazioni di parametri né la disponibilità in produzione. Usa il formato nativo per la specifica completa; la compatibilità OpenAI è un sottoinsieme separato e non offre long decode.

Riferimenti

• Specifica ufficiale del modello
• Guida alla migrazione di GenerateContent
• Decodifica lunga e continuazione
• Output strutturati

Gruppo LLM facoltativo

Accedi al Playground di questo modello per consultare i gruppi disponibili. Le opzioni dipendono dalle autorizzazioni del tuo account e dal modello selezionato. Playground usa la tua sessione di accesso; non devi fornire una chiave API.

Le chiamate API mantengono la tua chiave API e l’ID del modello. Per selezionare un gruppo, invia il suo nome esatto nell’header di richiesta facoltativo X-SeedRouter-Group. Sostituisci GROUP_NAME qui sotto con un nome mostrato in Playground. Ometti l’header o usa auto per mantenere il comportamento predefinito della chiave.

X-SeedRouter-Group: GROUP_NAME

Una chiave API con restrizioni può offrire meno gruppi rispetto a Playground. Le richieste vengono addebitate in base ai prezzi del gruppo selezionato e non passano a un altro gruppo se quello selezionato non è disponibile. Questa opzione supporta le chiamate LLM tramite HTTP, incluso SSE; non si applica alle chiamate WebSocket né a quelle per immagini o video.

Per controllare i gruppi disponibili per una specifica chiave API senza generare una risposta del modello, usa questo endpoint di sola lettura. data[].id è il valore da inserire nell’header; ratio è il moltiplicatore di prezzo dell’account per quel gruppo. La voce auto riflette la stima attuale della selezione predefinita; il suo moltiplicatore è null quando non è disponibile alcun gruppo predefinito. La disponibilità del gruppo viene verificata di nuovo quando chiami il modello.

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