Utiliser des clés API Gemini

Pour utiliser l'API Gemini, vous avez besoin d'une clé API. Vous pouvez créer une clé sans frais en quelques clics dans Google AI Studio.

Une fois que vous disposez d'une clé API, vous avez les options suivantes pour vous connecter à l'API Gemini :

• Définir votre clé API en tant que variable d'environnement
• Fournir explicitement votre clé API

Pour les tests initiaux, vous pouvez coder en dur une clé API, mais cela ne doit être que temporaire, car ce n'est pas sécurisé. Vous trouverez des exemples de codage en dur de la clé API dans la section Fournir la clé API explicitement.

Définir la clé API comme variable d'environnement

Si vous définissez la variable d'environnement GEMINI_API_KEY ou GOOGLE_API_KEY, la clé API sera automatiquement détectée par le client lors de l'utilisation de l'une des bibliothèques d'API Gemini. Nous vous recommandons de ne définir qu'une seule de ces variables. Toutefois, si les deux sont définies, GOOGLE_API_KEY est prioritaire.

Si vous utilisez l'API REST ou JavaScript dans le navigateur, vous devez fournir explicitement la clé API.

Voici comment définir votre clé API localement en tant que variable d'environnement GEMINI_API_KEY avec différents systèmes d'exploitation.

~/.bashrc

touch ~/.bashrc
open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc
open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

Fournir une clé API explicitement

Dans certains cas, vous pouvez fournir explicitement une clé API. Exemple :

• Vous effectuez un appel d'API simple et vous préférez coder en dur la clé API.
• Vous souhaitez un contrôle explicite sans avoir à vous fier à la découverte automatique des variables d'environnement par les bibliothèques d'API Gemini.
• Vous utilisez un environnement dans lequel les variables d'environnement ne sont pas prises en charge (par exemple, le Web) ou vous effectuez des appels REST.

Vous trouverez ci-dessous des exemples de méthodes permettant de fournir une clé API de manière explicite :

from google import genai

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

response = client.models.generate_content(
    model="gemini-2.5-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.5-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.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

package com.example;

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

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

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

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-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"
          }
        ]
      }
    ]
  }'

Sécuriser votre clé API

Il est important de sécuriser votre clé API Gemini. Voici quelques éléments à garder à l'esprit lorsque vous utilisez votre clé API Gemini :

• L'API Google AI Gemini utilise des clés API pour l'autorisation. Si d'autres personnes ont accès à votre clé API Gemini, elles peuvent effectuer des appels à l'aide du quota de votre projet, ce qui peut entraîner une perte de quota ou des frais supplémentaires pour les projets facturés, en plus d'accéder aux modèles et fichiers affinés.

• Ajouter des restrictions de clé API peut aider à limiter la surface utilisable via chaque clé API.

• Vous êtes responsable de la sécurité de votre clé API Gemini.

  • N'enregistrez PAS les clés API Gemini dans le contrôle des sources.
  • Les applications côté client (Web, Dart/Flutter) risquent d'exposer des clés API. Nous vous déconseillons d'utiliser les SDK client de l'IA de Google dans les applications de production pour appeler l'API Gemini de l'IA de Google directement depuis vos applications Web.

Pour connaître les bonnes pratiques générales, vous pouvez également consulter cet article d'aide.