Inizia a usare Gemini 4

Il primo modello Gemini 4 è Gemini 4 Argon (gemini-4-argon), il modello pionieristico di Google che eccelle nel lavoro approfondito in attività complesse del mondo reale in vari domini, tra cui programmazione, finanza, legale, sicurezza informatica e scienza.

Questa guida mostra come effettuare la prima richiesta a Gemini 4, descrive le novità di Gemini 4 e spiega le modifiche che si verificano quando esegui la migrazione da Gemini 3.1 Pro. Per dettagli specifici del modello, consulta la guida per gli sviluppatori di Gemini 4 Argon.

Guida rapida

Prima di iniziare, devi eseguire l'autenticazione a Gemini Enterprise Agent Platform utilizzando una chiave API o le credenziali predefinite dell'applicazione (ADC). Per ulteriori informazioni, consulta Metodi di autenticazione.

Installare l'SDK Google Gen AI

Esegui l'upgrade all'ultima versione dell'SDK google-genai (>= 2.30.1 per Python, @google/genai >= 2.29.1 per JavaScript):

pip install --upgrade "google-genai>=2.30.1"

Imposta le variabili di ambiente

Sostituisci GOOGLE_CLOUD_PROJECT con l'ID progetto Cloud de Confiance by S3NS . Gemini 4 Argon è disponibile sull'endpoint global e nelle multi-regioni us ed eu:

export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Effettua la tua prima richiesta

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-4-argon:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "How does AI work?" }
  }
}'

Novità di Gemini 4

Limite di token di input e output unificato

Gemini 4 Argon ha un limite unificato di 1.048.576 token che include sia i token di input sia quelli di output (dove l'output include il ragionamento, le chiamate di funzioni e la risposta finale). L'output può utilizzare fino a 1.048.576 token meno i token di input. Per impostazione predefinita, una singola richiesta sincrona genera fino a 65.536 token di output (o 32.768 token per le richieste HTTP dirette non in streaming).

Decodifiche lunghe

Quando un singolo turno richiede più di 65.536 (o 32.768 per le chiamate HTTP dirette non in streaming) token di output, ad esempio dimostrazioni formali, problemi di matematica o scientifici complessi o generazione di codice multi-file, Gemini 4 Argon supporta decodifiche lunghe fino a 1.048.576 token (meno i token di input) su GenerateContent (generateContent e streamGenerateContent). Con l'ultima versione dell'SDK Google Gen AI (google-genai >= 2.30.1 per Python, @google/genai >= 2.29.1 per JavaScript), l'impostazione di max_output_tokens maggiore di 65.536 (o maggiore di 32.768 per le richieste non in streaming) segue automaticamente continuation_token tra le richieste per restituire una singola risposta o flusso; per le chiamate REST dirette, passa il continuation_token da ogni risposta CONTINUATION alla richiesta successiva con lo stesso prompt.

Per esempi di codice, requisiti della versione dell'SDK e regole di implementazione, consulta Decodifiche lunghe nella guida per gli sviluppatori di Gemini 4 Argon.

Livelli di ragionamento

Utilizza thinking_level per controllare la quantità di ragionamento del modello prima di rispondere. Gemini 4 Argon supporta LOW, MEDIUM (impostazione predefinita su gemini-4-argon) e HIGH (impostazione predefinita su gemini-4-argon-cyber-permissive):

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Design a lock-free ring buffer in Rust for multi-producer, single-consumer telemetry ingestion.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level=types.ThinkingLevel.HIGH,
        ),
    ),
)
print(response.text)

Memorizzazione nella cache del contesto implicita

Gemini 4 Argon supporta la memorizzazione nella cache implicita per i prefissi di prompt condivisi di almeno 6144 token, con la memorizzazione nella cache durevole attivata per impostazione predefinita. Per usufruirne, inserisci contenuti statici, come un repository di codice o documenti lunghi, all'inizio del prompt.

Comprensione dei video agentica

La comprensione dei video agentica è disponibile a livello generale. È disattivata per impostazione predefinita: i video caricati utilizzano media_processing="static". Per attivarla, imposta media_processing su "agentic".

Parametri di campionamento

Gemini 4 Argon ignora i valori personalizzati per temperature, top_p e top_k, come fanno i recenti modelli Gemini 3. Per controllare l'output, utilizza thinking_level e l'output strutturato (response_schema).

Eseguire la migrazione da Gemini 3.1 Pro

Ti consigliamo di eseguire la migrazione da gemini-3.1-pro-preview a gemini-4-argon. Il seguente comportamento è diverso in Gemini 4 Argon:

Per eseguire la migrazione:

1. Modifica l'ID modello in gemini-4-argon ed esegui l'upgrade all' ultima versione dell'SDK Google Gen AI (google-genai >= 2.30.1 per Python).
2. Tieni conto del limite unificato di 1.048.576 token di input e output e del limite di output di 65.536 token (o 32.768 token HTTP diretti non in streaming) per singola richiesta (o configura decodifiche lunghe per output più grandi su GenerateContent).
3. Sostituisci thinking_budget e thinking_level="MINIMAL" con thinking_level impostato su LOW, MEDIUM, o HIGH.
4. Rimuovi i riferimenti espliciti cached_content.
5. Rimuovi temperature, top_p e top_k, che non hanno alcun effetto.

Gemini 4 Argon Cyber Permissive

Gemini 4 Argon Cyber Permissive è una versione di Gemini 4 Argon per i casi d'uso di cybersicurezza difensiva, disponibile dietro una lista consentita. Per le differenze e l'accesso, consulta Gemini 4 Argon Cyber Permissive.

Passaggi successivi

• Prova il tutorial del blocco note Introduzione a Gemini 4 Argon.
• Leggi la guida per gli sviluppatori di Gemini 4 Argon.
• Consulta la pagina del modello Gemini 4 Argon per le specifiche, le funzionalità supportate e le località.
• Scopri di più sul ragionamento.