Gemini 3.8 Flash (gemini-3.8-flash) è in disponibilità generale (GA) ed è pronto per l'utilizzo in produzione. È il nostro modello Flash più intelligente, progettato per l'ingegneria software a lungo termine, gli agenti autonomi e i workflow aziendali complessi.
Questa guida spiega le novità di Gemini 3.8 Flash, le modifiche all'API, gli esempi di codice e le indicazioni per la migrazione.
Nuovo modello
| Modello | ID modello | Livello di ragionamento predefinito | Prezzi | Descrizione |
|---|---|---|---|---|
| Gemini 3.8 Flash | gemini-3.8-flash |
medium |
3.8 Flash è disponibile fino alla fine dell'anno a un prezzo di lancio di 0,75 $per 1 milione di token di input e 3,75 $per 1 milione di token di output. Per maggiori dettagli, consulta la pagina dei prezzi. | Il nostro modello Flash più intelligente, progettato per l'ingegneria software a lungo termine, gli agenti autonomi e i workflow aziendali complessi. |
Gemini 3.8 Flash supporta una finestra contestuale di 1 milione di token, un massimo di 64.000 token di output, livelli di ragionamento regolabili (low, medium, high) e la stessa suite completa di strumenti integrati.
Per le specifiche complete, consulta la pagina del modello Gemini 3.8 Flash. Per i dettagli sui prezzi promozionali, consulta la sezione dei prezzi di seguito o la pagina dei prezzi.
Guida rapida
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Write a three.js script that renders a realistic 3D black hole."
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
model: "gemini-3.8-flash",
input: "Write a three.js script that renders a realistic 3D black hole.",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
REST
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"model": "gemini-3.8-flash",
"input": "Write a three.js script that renders a realistic 3D black hole."
}'
Novità di Gemini 3.8 Flash
- Ingegneria software a lungo termine: offre risultati ottimali nei benchmark di programmazione del mondo reale, nel refactoring complesso di più file e nell'esecuzione deterministica degli strumenti. Per maggiori dettagli, consulta la metodologia di valutazione.
- Agenti autonomi: ti consente di creare workflow resilienti di pianificazione multi-step e orchestrazione degli strumenti, riducendo notevolmente i loop e gli errori non riusciti.
- Workflow aziendali complessi: offre accuratezza superiore, ragionamento approfondito e rigore fattuale elevato per attività di dominio impegnative e pipeline di dati su larga scala.
- Modello predefinito per gli agenti gestiti: l'agente predefinito per gli agenti gestiti, l'agente Antigravity, ora utilizza Gemini 3.8 Flash. Per impostazione predefinita, anche l'SDK Antigravity utilizza Gemini 3.8 Flash.
- Prezzi promozionali: Gemini 3.8 Flash è disponibile a una tariffa promozionale di 0,75 $per 1 milione di token di input e 3,75 $per 1 milione di token di output fino al 31 dicembre 2026. I prezzi standard di 1,50 $per 1 milione di token di input e 7,50 $per 1 milione di token di output entreranno in vigore il 1° gennaio 2027.
Per impostazione predefinita, Gemini 3.8 Flash può utilizzare più token per le attività più lunghe e complesse. Per fornire risultati di qualità superiore per obiettivi difficili e multi-step, il modello esegue passaggi di ragionamento più piccoli, chiama gli strumenti in modo iterativo e verifica il suo lavoro man mano. Non tutti i workflow richiedono questo livello di verifica. Per le attività quotidiane, puoi ridurre lo sforzo di ragionamento per ridurre il consumo di token. In alternativa, Gemini 3.7 Flash rimane completamente supportato.
Informazioni sui livelli di ragionamento
Gemini 3.8 Flash ti offre un controllo flessibile sulla latenza e sull'intelligenza regolando il livello di ragionamento del modello:
- Impegno di ragionamento basso: riduce il tempo di risposta per le attività sensibili alla latenza, come le pipeline di risposta agli incidenti, la chat in tempo reale, la scrittura di bozze e l'analisi rapida dei dati.
- Medio (predefinito): la qualità migliore per la maggior parte delle attività. Consigliato per codice complesso e casi d'uso agentici, in quanto offre una maggiore accuratezza al primo passaggio.
- Impegno di ragionamento elevato: massimizza le capacità di ragionamento e di orchestrazione degli strumenti del modello. Ideale per ragionamenti approfonditi, matematica e attività multi-step difficili.
L'esempio seguente imposta thinking_level su medium per una richiesta di analisi del codice complessa:
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
generation_config={
"thinking_level": "medium" # Balanced reasoning effort for complex tasks
}
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
model: "gemini-3.8-flash",
input: "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
generation_config: {
thinking_level: "medium"
}
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
REST
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"model": "gemini-3.8-flash",
"input": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
"generation_config": {
"thinking_level": "medium"
}
}'
Agente Antigravity aggiornato
Grazie alle prestazioni e al ragionamento migliorati, l'agente Antigravity in Gemini Managed Agents ora è basato su Gemini 3.8 Flash per impostazione predefinita.
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input=(
"Audit https://web.dev for performance, Core Web Vitals, and SEO. "
"Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. "
"Check search indexing with Google Search for site:web.dev. "
"Format the output as a side-by-side scorecard table with prioritized fixes."
),
environment="remote",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
environment: "remote",
}, { timeout: 300000 });
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
REST
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google'\''s PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
"environment": "remote"
}'
Il modello Gemini sottostante può essere configurato utilizzando agent_config.
Elenco di controllo per la migrazione
`/gemini-api-dev migrate my app to Gemini 3.8 Flash`
Esegui la migrazione a gemini-3.8-flash
- Aggiorna l'ID modello: modifica la stringa del modello di destinazione in
gemini-3.8-flash. - Rimuovi i parametri di campionamento ritirati:
- Rimuovi
temperature,top_petop_kdalle configurazioni di generazione. - Sostituisci
thinking_budgetcon l'enumerazione di stringhethinking_level. Tieni presente cheminimalnon è supportato in 3.8 Flash. - Rimuovi
candidate_count(non supportato in Gemini 3 e versioni successive).
- Rimuovi
- Applica le regole di convalida dei turni:
- Standardizza le conversazioni multi-turno su
previous_interaction_idlato server. - Rimuovi i turni del modello precompilati.
- Standardizza le conversazioni multi-turno su
- Controlla la chiamata di funzione:
- Inserisci gli asset multimodali nel payload della risposta.
- Formatta le istruzioni in linea utilizzando
\n\n. - Se visualizzi errori
Malformed_Function_Callrelativi al testo pre-strumento, consulta Soluzioni alternative per i requisiti del testo pre-strumento. - Solo se utilizzi l'API generateContent: assicurati che tutti gli oggetti
FunctionResponseincludanocall_idename.
- Requisiti di base di Gemini 3: per gli aggiornamenti dell'SDK e la conservazione della firma del pensiero, consulta l'elenco di controllo per la migrazione a Gemini 3.5.
Prezzi
Approfitta dei prezzi promozionali in Google AI Studio e Gemini Enterprise Agent Platform fino al 31 dicembre 2026 per Gemini 3.8 Flash, Gemini 3.7 Flash e Gemini 3.6 Flash. I prezzi standard entreranno in vigore il 1° gennaio 2027. Per i livelli di prezzo completi, consulta la pagina dei prezzi.
Passaggi successivi
- Esamina le specifiche dell'API nella panoramica dei modelli.
- Esplora l'orchestrazione multi-agente nella panoramica dell'API Interactions.
- Testa e perfeziona i prompt in Google AI Studio.