Guida rapida dell'API Gemini

Questa guida rapida mostra come installare le nostre librerie ed effettuare la tua prima richiesta all'API Gemini utilizzando l'API Interactions.

Prima di iniziare

Per utilizzare l'API Gemini, devi disporre di una chiave API per autenticare le richieste, applicare limiti di sicurezza e monitorare l'utilizzo del tuo account.

Per iniziare, creane uno su AI Studio senza costi:

Crea una chiave API Gemini

Installa l'SDK Google GenAI

pip install -q -U google-genai

npm install @google/genai

Effettua la tua prima richiesta

Esistono due modi per inviare una richiesta all'API Gemini:

• (Consigliato) L'API Interactions è una nuova primitiva con supporto nativo per l'utilizzo di strumenti in più passaggi, l'orchestrazione e flussi di ragionamento complessi tramite passaggi di esecuzione digitati. In futuro, i nuovi modelli al di fuori della famiglia principale, insieme a nuove capacità agentiche e strumenti, verranno lanciati esclusivamente nell'API Interactions.
• generateContent consente di generare una risposta semplice e senza stato da un modello. Sebbene consigliamo di utilizzare l'API Interactions, generateContent è completamente supportata.

Questo esempio utilizza l'API Interactions per inviare una richiesta all'API Gemini utilizzando il modello Gemini 3 Flash.

Se imposti la chiave API come variabile di ambiente GEMINI_API_KEY, questa verrà rilevata automaticamente dal client quando utilizzi le librerie dell'API Gemini. In caso contrario, dovrai trasmettere la chiave API come argomento durante l'inizializzazione del client.

Tieni presente che tutti gli esempi di codice nella documentazione dell'API Gemini presuppongono che tu abbia impostato la variabile di ambiente GEMINI_API_KEY.

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Modalità stateless

Per impostazione predefinita, l'API Interactions gestisce lo stato della conversazione lato server quando utilizzi previous_interaction_id. Se preferisci gestire autonomamente la cronologia delle conversazioni lato client, puoi attivare la modalità stateless impostando store=false e passando i passaggi accumulati nel campo input delle richieste successive.

Per dettagli ed esempi completi di conversazioni stateless multi-turn, consulta la guida alla generazione di testo.

Passaggi successivi

Ora che hai effettuato la prima richiesta API, ti consigliamo di consultare le seguenti guide che mostrano Gemini in azione:

• Generazione di testo
• Generazione di immagini
• Comprensione delle immagini
• Ragionamento
• Chiamata di funzione
• Contesto lungo
• Incorporamenti