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

L'utilizzo dell'API Gemini richiede una chiave API, che puoi creare senza costi per iniziare.

Crea una chiave API Gemini

Installa l'SDK Google GenAI

Python

Utilizzando Python 3.9+, installa il pacchetto google-genai utilizzando il seguente comando pip:

pip install -q -U google-genai

JavaScript

Utilizzando Node.js v18+, installa SDK Google Gen AI per TypeScript e JavaScript utilizzando il seguente comando npm:

npm install @google/genai

Effettua la tua prima richiesta

Ecco un esempio che 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.

Python

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)

JavaScript

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();

REST

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-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Passaggi successivi

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