Guide de démarrage rapide de l'API Gemini

Ce guide de démarrage rapide vous explique comment installer nos bibliothèques et effectuer votre première requête à l'API Gemini.

Avant de commencer

Vous avez besoin d'une clé API Gemini. Si vous n'en avez pas encore, vous pouvez l'obtenir sans frais dans Google AI Studio.

Installer le SDK Google GenAI

PythonJavaScriptGoApps Script

Avec Python 3.9 ou version ultérieure, installez le package google-genai à l'aide de la commande pip suivante:

pip install -q -U google-genai

À l'aide de Node.js v18 ou version ultérieure, installez le SDK Google Gen AI pour TypeScript et JavaScript à l'aide de la commande npm suivante:

npm install @google/genai

Installez google.golang.org/genai dans votre répertoire de modules à l'aide de la commande go get:

go get google.golang.org/genai
  1. Pour créer un projet Apps Script, accédez à script.new.
  2. Cliquez sur Projet sans titre.
  3. Renommez le projet Apps Script AI Studio, puis cliquez sur Renommer.
  4. Définissez votre clé API.
    1. Sur la gauche, cliquez sur Paramètres du projet Icône des paramètres du projet.
    2. Sous Script Properties (Propriétés du script), cliquez sur Add script property (Ajouter une propriété de script).
    3. Dans Propriété, saisissez le nom de la clé: GEMINI_API_KEY.
    4. Dans Valeur, saisissez la valeur de la clé API.
    5. Cliquez sur Enregistrer les propriétés de script.
  5. Remplacez le contenu du fichier Code.gs par le code suivant:

Envoyer votre première requête

Utilisez la méthode generateContent pour envoyer une requête à l'API Gemini.

PythonJavaScriptGoApps 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"
          }
        ]
      }
    ]
  }'

Étape suivante

Maintenant que vous avez effectué votre première requête API, vous pouvez consulter les guides suivants qui présentent Gemini en action: