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 en obtenir une sans frais dans Google AI Studio.

Installer le SDK Google GenAI

Python

À l'aide de 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

JavaScript

À 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

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>

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. Sur la 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. Pour 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 :

Créer votre première demande

Voici un exemple qui utilise la méthode generateContent 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 lors de l'utilisation des 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-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"
          }
        ]
      }
    ]
  }'

L'option "Réflexion" est activée par défaut dans de nombreux exemples de code.

De nombreux exemples de code sur ce site utilisent le modèle Gemini 2.5 Flash, dont la fonctionnalité Réflexion est activée par défaut pour améliorer la qualité des réponses. Sachez que cela peut augmenter le temps de réponse et l'utilisation de jetons. Si vous privilégiez la vitesse ou souhaitez minimiser les coûts, vous pouvez désactiver cette fonctionnalité en définissant le budget de réflexion sur zéro, comme indiqué dans les exemples ci-dessous. Pour en savoir plus, consultez le guide de réflexion.

Python

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Explain how AI works in a few words",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_budget=0) # Disables thinking
    ),
)
print(response.text)

JavaScript

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

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",
    config: {
      thinkingConfig: {
        thinkingBudget: 0, // Disables thinking
      },
    }
  });
  console.log(response.text);
}

await main();

Go

package main

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

func main() {

  ctx := context.Background()
  client, err := genai.NewClient(ctx, nil)
  if err != nil {
      log.Fatal(err)
  }

  result, _ := client.Models.GenerateContent(
      ctx,
      "gemini-2.5-flash",
      genai.Text("Explain how AI works in a few words"),
      &genai.GenerateContentConfig{
        ThinkingConfig: &genai.ThinkingConfig{
            ThinkingBudget: int32(0), // Disables thinking
        },
      }
  )

  fmt.Println(result.Text())
}

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"
          }
        ]
      }
    ]
    "generationConfig": {
      "thinkingConfig": {
        "thinkingBudget": 0
      }
    }
  }'

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

Étape suivante

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