Gemini 3.1 Pro — ragiona su codice e documenti
Gemini 3.1 Pro riunisce testo, immagini, audio, video e PDF in una conversazione. Scegli un livello di ragionamento, richiedi testo strutturato e conserva le parti originali della conversazione quando la tua applicazione chiama strumenti. 0,80 USD / 1M input · 4,80 USD / 1M output.
- Input da 1M di token
- Output da 65.536 token
- Tre livelli di ragionamento
- Chiamate a funzioni
- Input multimodale
Playground
Esplora Gemini 3.1 Pro con richieste native. Scegli un gruppo dell’account, esamina le impostazioni e invia usando il tuo saldo. La verifica dal vivo delle capacità è ancora da completare.
gemini-3.1-pro-preview$0.80 input · $4.80 output per milione di tokenAltri parametri Gemini
Prova uno di questi prompt
I messaggi si addebitano dal tuo credito alle tariffe sottostanti, come una chiamata API. Le richieste non riuscite sono gratuite.
Prezzi di Gemini 3.1 Pro
I prezzi di Gemini 3.1 Pro qui sotto provengono dalle impostazioni di fatturazione attuali. Confronta i gruppi disponibili per il tuo account e le relative tariffe di input, output e input in cache. Le richieste con oltre 200.000 token di input non in cache usano la fascia per il contesto lungo.
Le dimensioni degli esempi sono indicative. Il tuo addebito si basa sui token dichiarati da ogni richiesta. Tariffe di elaborazione Standard. La soglia di 200.000 token si calcola sull’input non in cache. I token in cache vengono addebitati separatamente e non vengono addebitati di nuovo come input non in cache. I costi degli strumenti e dell’archiviazione della cache sono separati da questi esempi di token.
| Categoria | googlellm · ≤ 200.000 token di input non in cachePrezzo · 1M di token | googlellm · > 200.000 token di input non in cachePrezzo · 1M di token | googlellm-vertext · ≤ 200.000 token di input non in cachePrezzo · 1M di token | googlellm-vertext · > 200.000 token di input non in cachePrezzo · 1M di token |
|---|---|---|---|---|
| Input | $0.80 | $1.60 | $1.00 | $2.00 |
| Output, incluso il ragionamento | $4.80 | $7.20 | $6.00 | $9.00 |
| Input in cache | $0.08 | $0.16 | $0.10 | $0.20 |
Solo l’input non in cache determina la fascia tariffaria. L’input in cache viene addebitato separatamente alla tariffa di quella fascia. Gli esempi usano la fascia standard.
Che cos’è Gemini 3.1 Pro?
Gemini 3.1 Pro è un modello di ragionamento di Google per comprendere codice, confrontare documenti e spiegare informazioni in diversi contenuti multimediali. Fornisci insieme il materiale, la domanda e il formato di risposta atteso.
Usa gemini-3.1-pro-preview per la versione normale di Gemini 3.1 Pro. Google documenta anche una variante customtools specializzata nella selezione degli strumenti. Questa pagina collega la versione normale; la profondità del ragionamento è un’impostazione separata.
Limiti ufficiali del modello verificati il 17 ottobre 2026. Input e output hanno limiti separati.
Inizia con Gemini 3.1 Pro
Inizia con un’attività rappresentativa. Salva input e impostazioni per il confronto.
Prova il Playground
Invia un messaggio a Gemini 3.1 Pro, allega materiale di supporto ed esamina la richiesta JSON nativa prima dell’invio. I controlli ufficiali usano nomi e tipi dei campi nativi; il JSON personalizzato viene inviato senza modifiche perché sia l’API Gemini a convalidarlo.
Scegli il gruppo del tuo account
Scegli tra i gruppi Gemini 3.1 Pro disponibili per il tuo account. Il Playground aggiorna le tariffe in base alla selezione; eventuali gruppi aggiuntivi compaiono nello stesso elenco basato sull’account.
Usa il riferimento API
Copia un esempio nativo di Gemini 3.1 Pro nella tua applicazione. Il riferimento elenca i campi di richiesta e risposta, gli input multimediali e le capacità che richiedono ancora una verifica dal vivo.
Cosa puoi creare con Gemini 3.1 Pro
Scegli un contratto di output, poi verifica il risultato confrontandolo con il materiale originale.
Analizza una modifica
Chiedi a Gemini 3.1 Pro di seguire un bug tra funzioni correlate, spiegare le proprie ipotesi e proporre una correzione mirata. Esegui i tuoi test prima di accettare la modifica.
Ottieni dati strutturati
Fornisci a Gemini 3.1 Pro uno schema di risposta JSON per l’estrazione o la classificazione. Verifica i valori restituiti confrontandoli con il documento; il solo JSON valido non dimostra l’esattezza dei fatti.
Lavora con le tue funzioni
Dichiara funzioni con un nome e i relativi schemi degli argomenti. Gemini 3.1 Pro può restituire una chiamata a funzione che la tua applicazione eseguirà; il tuo codice decide quali azioni sono consentite.
Confronta contenuti multimediali e testo
Affianca alla domanda un grafico, uno screenshot o un PDF. Gemini 3.1 Pro accetta input multimodali e restituisce testo, utile per spiegazioni basate sul materiale fornito.
Attività pratiche con Gemini 3.1 Pro
Flussi di lavoro suggeriti; non si dichiarano risultati di benchmark o di clienti.
Esamina una modifica al repository
Fornisci a Gemini 3.1 Pro i file pertinenti e il test non superato. Chiedi la modifica minima che risolva il problema, con una spiegazione separata delle incertezze rimanenti.
Estrai una checklist da un documento
Chiedi a Gemini 3.1 Pro di trasformare un documento fornito in una checklist strutturata. Includi nello schema i riferimenti alle posizioni nel documento, così chi revisiona può controllare ogni voce estratta.
Spiega una dimostrazione registrata
Fornisci un breve video supportato e chiedi a Gemini 3.1 Pro di descrivere un passaggio specifico. Limita la domanda alle prove visibili e chiedi di identificare i dettagli poco chiari.
Come usare Gemini 3.1 Pro
- 01
Prepara l’accesso
Accedi, aggiungi credito e crea una chiave API da usare sul server. Apri Gemini 3.1 Pro nel Playground per esaminare il formato della richiesta.
- 02
Fornisci il contesto
Inserisci il prompt e la conversazione precedente in contents. Per l’input multimediale di Gemini 3.1 Pro, includi il tipo MIME corretto e un riferimento a file supportato.
- 03
Scegli ragionamento e output
Usa il ragionamento low, medium o high. Gemini 3.1 Pro usa high per impostazione predefinita; imposta maxOutputTokens consapevolmente quando conta la lunghezza della risposta.
- 04
Controlla la risposta
Leggi candidates, finishReason e usageMetadata. Conserva le firme di ragionamento e le parti degli strumenti di Gemini 3.1 Pro quando invii il turno successivo.
L’API nativa di Gemini 3.1 Pro
Gemini 3.1 Pro usa generateContent per le risposte JSON e streamGenerateContent per gli eventi inviati dal server. Il riferimento separato include esempi da copiare e lo schema completo dei parametri.
Nome esatto del modello
Usa gemini-3.1-pro-preview nell’URL. Un nome visualizzato come Gemini 3.1 Pro non è un identificatore API intercambiabile.
Impostazioni di generazione esplicite
Gemini 3.1 Pro mantiene temperature e i campi di campionamento. Google consiglia temperature 1.0. Livello di ragionamento, formato di output e strumenti restano controlli distinti.
Leggi il consumo effettivo
Il consumo di output di Gemini 3.1 Pro include i token di ragionamento. L’input in cache resta incluso nell’input totale per la soglia di contesto e viene addebitato alla tariffa dell’input in cache.
Due varianti ufficiali di Gemini 3.1 Pro
La differenza riguarda la selezione degli strumenti, non un secondo livello di ragionamento. Questa pagina collega solo il modello normale di Gemini 3.1 Pro.
| Scelta | Preview normale | Customtools Preview |
|---|---|---|
| ID API | gemini-3.1-pro-preview | gemini-3.1-pro-preview-customtools |
| Scopo documentato | Ragionamento generale e uso di strumenti | Priorità agli strumenti personalizzati quando è disponibile anche bash |
| Chiamate a funzioni | Supportate | Comportamento specializzato nella selezione degli strumenti |
| Domanda di valutazione | Risolve l’attività reale? | Sceglie lo strumento personalizzato previsto? |
Google avverte che Customtools può mostrare variazioni di qualità al di fuori del flusso previsto. Questo è un confronto basato sulla documentazione, non un nuovo benchmark A/B. Documentazione del modello di Google
Limiti di Gemini 3.1 Pro
Separa i budget di input e output
Gemini 3.1 Pro accetta fino a 1.048.576 token di input e produce fino a 65.536 token di output. Il ragionamento usa il budget di output; anche una risposta breve può richiedere token di ragionamento.
Solo output testuale
Gemini 3.1 Pro può analizzare i contenuti multimediali supportati, ma non genera immagini o audio. Usa un modello di generazione dedicato per questi output.
Controlla le capacità avanzate
La specifica ufficiale di Gemini 3.1 Pro indica il supporto degli strumenti. Qui restano da completare le verifiche dal vivo di contenuti multimediali, cache e singoli strumenti; accettare un parametro non ne dimostra il comportamento.
Le risorse cache richiedono accesso
Un valore cachedContent identifica una risorsa cache esistente. Gemini 3.1 Pro non può usare una cache solo perché il nome ha il formato corretto; restano necessari l’accesso alla risorsa e la compatibilità del modello.
Usa Gemini 3.1 Pro con SeedRouter
Un solo saldo dell’account
Usa lo stesso saldo SeedRouter per Gemini 3.1 Pro e gli altri modelli di testo, immagini e video elencati. Rispetta il formato delle richieste e i vincoli di ciascun modello.
Prezzi accanto al modello
Controlla le tariffe per token di Gemini 3.1 Pro in questa pagina e seleziona il gruppo dell’account che intendi usare. La tabella dei prezzi segue le impostazioni di fatturazione attuali.
Paga le richieste riuscite
Le richieste non riuscite di Gemini 3.1 Pro non vengono addebitate. Per quelle riuscite si usa il consumo di token riportato, inclusi ragionamento e input in cache.
Esplora altri modelli di testo
Confronta capacità documentate e tariffe attuali dei modelli di testo disponibili.
Chiama GPT-6 Astra con l'SDK OpenAI. Il modello più potente di OpenAI, con contesto da 1.05M di token, prezzi al token in tempo reale e un Playground che puoi provare subito.
Visualizza i prezziUsa GPT-6 Sol con l'SDK OpenAI: contesto da 1.05M di token, sforzo di ragionamento da none a max, prezzi per token in tempo reale e un Playground da provare subito.
Visualizza i prezziUsa GPT-6.1 Sol con l'SDK OpenAI: coding e agenti quasi da Astra a un quinto del prezzo, contesto da 1.05M di token, input in cache scontato del 95%. Provalo.
Visualizza i prezziChiama GPT-6 Luna con l'SDK di OpenAI. Il modello GPT-6 più economico, con contesto da 1.05M di token, prezzi per token in tempo reale e un Playground da provare subito.
Visualizza i prezziProva Claude Haiku 5.5 per classificare, estrarre dati e riassumere. Consulta i prezzi attuali dei token, prova i tuoi prompt e usa Messages nella tua app.
Visualizza i prezziProva Claude Sonnet 5.5 per codice e documenti. Consulta i prezzi per token, prova i prompt e verifica le funzioni testate prima di collegare la tua app.
Visualizza i prezziGuide a Gemini 3.1 Pro
Comprendi i due ID ufficiali del modello prima di scegliere le impostazioni per la tua applicazione.
Confronta i due ID ufficiali di Gemini 3.1 Pro, cosa cambia con Customtools e quando il modello Preview normale è adatto alla tua applicazione.
Confronta Gemini 3.8 Flash e Gemini 3.1 Pro per ragionamento predefinito, stato, limiti di token e criteri di valutazione, senza presumere vincitori universali.
Domande frequenti su Gemini 3.1 Pro
Quale ID del modello Gemini 3.1 Pro devo usare?+
Qui Gemini 3.1 Pro usa gemini-3.1-pro-preview. La variante separata customtools dà priorità agli strumenti personalizzati quando è disponibile anche bash.
Qual è il livello di ragionamento predefinito di Gemini 3.1 Pro?+
Gemini 3.1 Pro usa high per impostazione predefinita. Sono supportati low e medium, ma non minimal. Non combinare thinkingLevel e thinkingBudget.
Perché i prezzi di Gemini 3.1 Pro cambiano oltre 200K token di input?+
Le tariffe attuali usano due fasce; quella superiore si applica oltre 200.000 token di input non in cache. L’input in cache viene addebitato separatamente alla tariffa per l’input in cache della fascia selezionata. Consulta la tabella aggiornata per ciascun gruppo dell’account.
Gemini 3.1 Pro può generare immagini?+
Gemini 3.1 Pro accetta i contenuti multimediali supportati, ma restituisce testo. Usa un modello per immagini quando ti serve un’immagine generata.
Serve Customtools per le chiamate a funzioni di Gemini 3.1 Pro?+
Gemini 3.1 Pro normale supporta le chiamate a funzioni. Customtools modifica il comportamento di selezione degli strumenti; non è necessario per dichiarare funzioni.
Prova Gemini 3.1 Pro
Inizia con un prompt rappresentativo, esamina la richiesta nativa e verifica il risultato rispetto alla tua attività.