Guida rapida all'API Gemini

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

Prima di iniziare

Devi disporre di una chiave API Gemini. Se non ne hai già uno, puoi ottenerlo senza costi in Google AI Studio.

Installa l'SDK Google GenAI

PythonJavaScriptVaiApps Script

Utilizzando Python 3.9 e versioni successive, installa il pacchetto google-genai con il seguente comando pip:

pip install -q -U google-genai

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

npm install @google/genai

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

go get google.golang.org/genai
  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'icona per le impostazioni del progetto.
    2. In Proprietà script, fai clic su Aggiungi proprietà script.
    3. In Proprietà, inserisci il nome della chiave: GEMINI_API_KEY.
    4. In 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

Utilizza il metodo generateContent per inviare una richiesta all'API Gemini.

PythonJavaScriptVaiApps ScriptREST 
from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash", contents="Explain how AI works in a few words"
)
print(response.text)

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    if err != nil {
        log.Fatal(err)
    }

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

// 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.0-flash:generateContent?key=${apiKey}`;
  const options = {
    method: 'POST',
    contentType: 'application/json',
    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);
}

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$YOUR_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 tua prima richiesta API, ti consigliamo di consultare le seguenti guide che mostrano Gemini in azione: