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 d'API Gemini.

Avant de commencer

Pour utiliser l'API Gemini, vous devez disposer d'une clé API pour authentifier vos requêtes, appliquer des limites de sécurité et suivre l'utilisation de votre compte.

Pour commencer, créez-en une sans frais dans AI Studio :

Créer une clé API Gemini

Installer le SDK Google GenAI

Python

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

pip install -q -U google-genai

JavaScript

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

npm install @google/genai

Go

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

go get google.golang.org/genai

Java

Si vous utilisez Maven, vous pouvez installer google-genai en ajoutant les éléments suivants à vos dépendances :

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

C#

Installez googleapis/go-genai dans le répertoire de votre module à l'aide de la commande dotnet add.

dotnet add package Google.GenAI

Apps Script

  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. À gauche, cliquez sur Paramètres du projet Icône des paramètres du projet.
    2. Sous Propriétés du script , cliquez sur Ajouter une propriété de script.
    3. Dans le champ Propriété, saisissez le nom de la clé : GEMINI_API_KEY.
    4. Dans le champ Valeur, saisissez la valeur de la clé API.
    5. Cliquez sur Enregistrer les propriétés du script.
  5. Remplacez le contenu du fichier Code.gs par le code suivant :

Effectuer votre première requête

Vous pouvez envoyer une requête à l'API Gemini de deux manières :

  • (Recommandé) L'API Interactions est une nouvelle primitive qui prend en charge nativement l'utilisation d'outils en plusieurs étapes, l'orchestration et les flux de raisonnement complexes via des étapes d'exécution typées. À l'avenir, les nouveaux modèles au-delà de la famille principale, ainsi que les nouvelles capacités agentiques et outils, seront lancés exclusivement sur l'API Interactions.
  • generateContent permet de générer une réponse simple et sans état à partir d'un modèle. Nous vous recommandons d'utiliser l'API Interactions, mais generateContent est entièrement compatible.

Cet exemple utilise la generateContent méthode pour envoyer une requête à l'API Gemini à l'aide du modèle Gemini 2.5 Flash.

Si vous définissez votre clé API comme variable d'environnement GEMINI_API_KEY, elle sera automatiquement récupérée par le client lorsque vous utiliserez les bibliothèques de l'API Gemini. Sinon, vous devrez transmettre votre clé API en tant qu'argument lors de l'initialisation du client.

Notez que tous les exemples de code de la documentation de l'API Gemini supposent que vous avez défini la variable d'environnement 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-3-flash-preview", 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-3-flash-preview",
    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-3-flash-preview",
        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-3-flash-preview",
            "Explain how AI works in a few words",
            null);

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

C#

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GOOGLE_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-3-flash-preview", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].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-3-flash-preview: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-3-flash-preview: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"
          }
        ]
      }
    ]
  }'

Étape suivante

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