Guida rapida all'API Gemini

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

Prima di iniziare

Devi avere una chiave API Gemini. Se non ne hai già una, puoi ottenerla senza costi in Google AI Studio.

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 Google Gen AI SDK per TypeScript e JavaScript utilizzando il seguente comando npm:

npm install @google/genai

Go

Installa google.golang.org/genai nella directory del modulo utilizzando il comando go get:

go get google.golang.org/genai

Java

Se utilizzi Maven, puoi installare google-genai aggiungendo quanto segue alle dipendenze:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

Apps Script

  1. Per creare un nuovo progetto Apps Script, vai a script.new.
  2. Fai clic su Progetto senza titolo.
  3. Rinomina il progetto Apps Script AI Studio e fai clic su Rinomina.
  4. Imposta la chiave API
    1. A sinistra, fai clic su Impostazioni progetto L&#39;icona delle impostazioni del progetto.
    2. Nella sezione Proprietà script, fai clic su Aggiungi proprietà script.
    3. In Proprietà, inserisci il nome della chiave: GEMINI_API_KEY.
    4. Per Valore, inserisci il valore della chiave API.
    5. Fai clic su Salva proprietà script.
  5. Sostituisci i contenuti del file Code.gs con il seguente codice:

Effettua la tua prima richiesta

Ecco un esempio che utilizza il metodo generateContent per inviare una richiesta all'API Gemini utilizzando il modello Gemini 2.5 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()

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.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 response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Go

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

Apps Script

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "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: