Obtenir une clé API Gemini

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

Obtenir une clé API Gemini dans Google AI Studio

Configurer 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é. Le reste de cette section explique comment configurer votre clé API en local en tant que variable d'environnement avec différents systèmes d'exploitation.

Linux/macOS : Bash

Bash est une configuration de terminal courante sous Linux et macOS. Vous pouvez vérifier si vous disposez d'un fichier de configuration en exécutant la commande suivante:

~/.bashrc

Si la réponse est "Aucun fichier ou répertoire de ce type", vous devez créer ce fichier et l'ouvrir en exécutant les commandes suivantes ou en utilisant zsh:

touch ~/.bashrc
open ~/.bashrc

Vous devez ensuite définir votre clé API en ajoutant la commande d'exportation suivante:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Après avoir enregistré le fichier, appliquez les modifications en exécutant la commande suivante:

source ~/.bashrc

macOS - Zsh

Zsh est une configuration de terminal courante sous Linux et macOS. Vous pouvez vérifier si vous disposez d'un fichier de configuration en exécutant la commande suivante:

~/.zshrc

Si la réponse est "Aucun fichier ou répertoire de ce type", vous devez créer ce fichier et l'ouvrir en exécutant les commandes suivantes ou en utilisant bash:

touch ~/.zshrc
open ~/.zshrc

Vous devez ensuite définir votre clé API en ajoutant la commande d'exportation suivante:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Après avoir enregistré le fichier, appliquez les modifications en exécutant la commande suivante:

source ~/.zshrc

Windows

  1. Recherchez "Variables d'environnement" dans les paramètres système.
  2. Modifiez "Variables utilisateur" (pour l'utilisateur actuel) ou "Variables système" (pour tous les utilisateurs, à utiliser avec précaution).
  3. Créer la variable et ajouter export GEMINI_API_KEY=your_key_here
  4. Appliquer les modifications

Envoyer votre première requête à l'API Gemini

Vous pouvez utiliser une commande curl pour vérifier votre configuration:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Sécuriser votre clé API

Il est important de sécuriser votre clé API Gemini. Voici quelques points à 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 (Android, Swift, Web et 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 à partir de vos applications mobiles et Web.

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