Guida introduttiva

Questa guida ti aiuta a iniziare a utilizzare l'API Gemini utilizzando l'API Interactions. Eseguirai la tua prima chiamata API in meno di un minuto ed esplorerai la generazione di testo, la comprensione multimodale, la generazione di immagini, l'output strutturato, gli strumenti, la chiamata di funzione, gli agenti e l'esecuzione in background.

L'API Interactions è disponibile tramite gli SDK Python e JavaScript, nonché tramite REST.

1. Ottieni una chiave API

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.

• Google AI Studio crea automaticamente un progetto e una chiave API per i nuovi utenti. Puoi copiarla dalla pagina Chiavi API.
• Se hai bisogno di una nuova chiave, fai clic su Crea chiave API in AI Studio e segui la finestra di dialogo per aggiungere una nuova coppia chiave-progetto.

Crea una chiave API Gemini

Imposta la chiave come variabile di ambiente:

export GEMINI_API_KEY="YOUR_API_KEY"

Eseguire l'upgrade al livello a pagamento

L'upgrade al livello a pagamento aumenta i limiti di frequenza e richiede la configurazione di fatturazione Cloud.

• Fai clic su Configura la fatturazione nelle pagine Chiavi API o Progetti di AI Studio.
• Segui la finestra di dialogo Fatturazione Cloud per creare o collegare un account di fatturazione, aggiungere un metodo di pagamento e pagare in anticipo un minimo di 10 $ (o l'equivalente in valuta) in crediti a pagamento.
• Visualizza l'utilizzo dell'API in Google AI Studio in Dashboard > Utilizzo.

Per ulteriori informazioni, consulta la pagina Fatturazione.

2. Installa l'SDK ed effettua la tua prima chiamata

Installa l'SDK e genera il testo con una singola chiamata API.

pip install -U google-genai

from google import genai

client = genai.Client()

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

npm install @google/genai

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.6-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works in a few words"
  }'

Risposta:

{
  "id": "v1_ChdpQUFvYXI...",
  "status": "completed",
  "usage": {
    "total_tokens": 197,
    "total_input_tokens": 8,
    "total_output_tokens": 12
  },
  "created": "2026-06-09T12:01:25Z",
  "steps": [
    {
      "type": "thought",
      "signature": "EvEFCu4FAQw..."
    },
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "AI learns patterns from data, then uses those patterns to make predictions or decisions on new data."
        }
      ]
    }
  ],
  "object": "interaction",
  "model": "gemini-3.6-flash",
}

Quando utilizzi REST, l'API restituisce la risorsa Interaction completa contenente metadati, statistiche di utilizzo e la cronologia passo passo della svolta.

Sebbene gli SDK espongano la risposta completa, forniscono anche proprietà pratiche come interaction.output_text e interaction.output_image per accedere direttamente agli output finali. Scopri di più sulla struttura della risposta nella