Introduzione
L’API Gemini 4 Argon porta il modello di ragionamento di Google nelle indagini sul software e nei lavori a più passaggi, con testo, immagini e audio nella stessa chat. Il contesto di 1,048,576 token è condiviso da ingresso, ragionamento e uscita. Nell’endpoint sincrono di Argon, max_tokens parte da 4,096 e arriva a 65,536 includendo il ragionamento; il modo long decode separato non è disponibile qui, quindi lascia spazio alla risposta nel contesto condiviso.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Testo |
| Contesto condiviso | 1,048,576 token condivisi fra ingresso, ragionamento e uscita di Argon |
| Limite di max_tokens | 65,536 |
Caratteristiche principali
Il contesto condiviso di Argon per le indagini
L’API Gemini 4 Argon porta il modello di ragionamento di Google nelle indagini sul software e nei lavori a più passaggi, con testo, immagini e audio nella stessa chat. Il contesto di 1,048,576 token è condiviso da ingresso, ragionamento e uscita. Per un’indagine con Argon, chiedi il passaggio che sostiene ogni risultato e il controllo che risolverebbe il dubbio prima di accettare una modifica al codice.
Immagini e registrazioni accanto alla domanda
Un messaggio utente può mescolare testo con parti image_url e audio, inviato come audio_url o come input_audio in base64, in formato wav o mp3. Grafici, screenshot, pagine scansionate e note vocali convivono nella stessa conversazione delle tue istruzioni, il che è adatto alle indagini in cui le prove non sono tutte testo.
Tre livelli di ragionamento, un solo campo
reasoning_effort accetta low, medium o high, e il valore predefinito è medium. Usa low per ricerche rapide e riscritture, medium per l’analisi quotidiana e high quando una risposta sbagliata costa più dei token in più. Il ragionamento viene conteggiato in max_tokens, quindi alza il limite insieme al livello.
Strumenti che lasciano la tua applicazione al comando
Gemini 4 Argon può rispondere con una chiamata di funzione invece che con testo discorsivo. Il tuo codice valida gli argomenti, esegue l’operazione e restituisce il risultato come messaggio di strumento: il modello propone un passo e la tua applicazione decide se farlo.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
messages | Sì | Invia ad Argon passaggi originali, schermate e conversazione in messages, conservando |
max_tokens | No | Nell’endpoint sincrono di Argon, |
reasoning_effort | No | Argon offre |
stop | No | Argon accetta da uno a quattro marcatori di arresto e termina la risposta prima del primo riconosciuto, senza restituire il marcatore come contenuto. almeno 1 caratteri · almeno 1 elementi · al massimo 4 elementi |
temperature | No | La temperature di Argon va da 0 a 2; conserva il valore predefinito per la prima verifica dei riscontri e cambia il campionamento solo per ottenere un altro stile di risposta. |
top_p | No | Il |
tools | No | Definisci fino a 128 funzioni che Argon può richiedere durante un’indagine su codice o documenti; la tua applicazione verifica gli argomenti, esegue l’operazione e restituisce i… al massimo 128 elementi |
parallel_tool_calls | No |
|
tool_choice | No | Per il prossimo passo di Argon, |
response_format | No | Usa |
Prezzi
Input $4 / Output $20 per 1 milione di token
Casi d’uso
Incrocia un insieme di documenti
Invia contratto, addendum e thread di email in un’unica richiesta e chiedi quali obblighi sono cambiati, citando il passaggio su cui si basa ogni risposta. Assegna a ogni fonte un’etichetta breve e indica quale versione prevale quando due si contraddicono.
Verifica un repository rispetto a una specifica
Metti la specifica e i file sorgente pertinenti in un’unica conversazione e chiedi le difformità che puoi ricondurre a una riga precisa. Con i chiamanti sotto gli occhi, la revisione può seguire una funzione attraverso più file. Imposta reasoning_effort su high per i casi difficili.
Interpreta grafici, screenshot e chiamate
Allega lo screenshot di una dashboard e la registrazione di uno stand-up, e chiedi che cosa è cambiato e che cosa resta ancora da decidere. Indica a quale immagine o clip si riferisce ogni domanda, così il modello non deve indovinare.
Guida un ciclo di agente con i tuoi strumenti
Definisci fino a 128 funzioni, lascia che il modello richieda chiamate, eseguile tu e rimanda indietro i risultati. Mantieni il ciclo breve, valida ogni argomento e fermati a un limite di passaggi controllato dal tuo codice.
Consigli avanzati
Ordina le fonti di Argon prima della domanda finale
Metti i documenti lunghi all’inizio della conversazione e fai la domanda dopo. Tieni ruolo, tono e formato di output nel messaggio di sistema, così restano validi qualunque sia la lunghezza della cronologia.
Scegli un livello, poi lascia spazio al ragionamento
Parti da medium.
max_tokensè 4,096 per impostazione predefinita e comprende il ragionamento; per un rapporto lungo o un’esecuzione ad alto sforzo impostalo ben sopra la lunghezza che prevedi di leggere, fino a 65,536.Etichetta ciò che alleghi
Dai un nome a ogni documento e indica a quale immagine o clip audio si riferisce una domanda. Tieni separate le istruzioni dal testo sorgente citato, perché una frase dentro un documento non venga presa per la tua richiesta.
Chiedi un contratto che puoi verificare
Per un output leggibile da macchina passa un
response_formatoppure definisci uno strumento i cui parametri sono i campi che ti servono, poi valida il risultato prima di agire.
L’API Gemini 4 Argon porta il modello di ragionamento di Google nelle indagini sul software e nei lavori a più passaggi, con testo, immagini e audio nella stessa chat. Il contesto di 1,048,576 token è condiviso da ingresso, ragionamento e uscita.
google/gemini-4-argon/chat — /v1/chat/completions
Nell’endpoint sincrono di Argon, max_tokens parte da 4,096 e arriva a 65,536 includendo il ragionamento; il modo long decode separato non è disponibile qui, quindi lascia spazio alla risposta nel contesto condiviso.
Argon offre reasoning_effort low, medium e high, con medium predefinito; aumenta il limite di uscita per un ragionamento più profondo, che qui non puoi disattivare.
Invia ad Argon passaggi originali, schermate e conversazione in messages, conservando tool_call_id per i risultati delle funzioni; l’audio deve essere incorporato e rispettare il limite totale dei media di 14 MB.
Per un’indagine con Argon, chiedi il passaggio che sostiene ogni risultato e il controllo che risolverebbe il dubbio prima di accettare una modifica al codice.
Definisci fino a 128 funzioni che Argon può richiedere durante un’indagine su codice o documenti; la tua applicazione verifica gli argomenti, esegue l’operazione e restituisce il risultato con tool_call_id.
Usa response_format per una tabella di riscontri di Argon in JSON e controlla campi e tipi nella tua applicazione prima di usarla.
Le decisioni sui contenuti di Argon valgono anche per le richieste NSFW di questa chat; SpicyAPI non garantisce risposte senza restrizioni dal modello di ragionamento di Google.
Avvio rapido dell’API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-argon/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
