Obtenir une clé d'API

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

Obtenir une clé API

Valider votre clé API à l'aide d'une commande curl

Vous pouvez utiliser une commande curl pour vérifier votre configuration. Vous pouvez transmettre la clé API via l'URL suivante:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Ou dans l'en-tête x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

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 les autorisations. Si d'autres utilisateurs obtiennent l'accès à votre clé API Gemini, ils peuvent effectuer des appels en utilisant le quota de votre projet, ce qui peut entraîner une perte de quota ou des frais supplémentaires (si la facturation est activée). Les clés API sécurisent également l'accès aux modèles et aux fichiers réglés.

  • Lorsque vous cliquez sur Obtenir une clé API dans Google AI Studio, vous choisissez de provisionner une clé API Gemini dans un projet Google Cloud nouveau ou existant. La liste des clés API dans Google AI Studio indique toutes les clés API qu'AI Studio a provisionnées pour une utilisation avec l'API Google AI Gemini (ainsi que tous les projets Google Cloud associés).

    • Cependant, n'importe quelle clé API du projet Google Cloud peut être utilisée pour appeler l'API Google AI Gemini. Vous pouvez afficher et gérer toutes les clés API de votre projet dans le panneau API et services > Identifiants de la console Google Cloud.

  • L'ajout de restrictions de clé API peut vous aider à limiter la surface utilisable avec chaque clé API. Par défaut, la clé API Gemini générée par Google AI Studio ne peut être utilisée qu'avec l'API Generative AI de Google (officiellement appelée "API Generative Language" ou generativelanguage.googleapis.com).

    • Si des clés API de votre projet Google Cloud ne disposent pas de restrictions d'API, ou si des clés API ont été ajoutées à la liste d'autorisation de l'API de langage génératif, elles peuvent être utilisées avec l'API Google AI Gemini. Il est recommandé de limiter chaque clé API aux seules API que vous appelez à l'aide de cette clé.
    • Notez que même avec les restrictions de clé API, si un acteur malveillant obtient votre clé API, il peut l'utiliser pour effectuer des appels en utilisant le quota de votre projet pour toutes les API ajoutées à la liste d'autorisation pour cette clé API.

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

    • NE activez PAS les clés API Gemini dans le contrôle du code source.
    • Les applications côté client (Android, Swift, Web et Dart/Flutter) risquent d'exposer des clés API. Nous vous déconseillons donc d'utiliser les SDK clients Google AI dans les applications de production pour appeler l'API Google AI Gemini directement à partir de vos applications mobiles et Web. Consultez les guides de démarrage rapide des SDK pour connaître les bonnes pratiques propres à chaque langage afin de sécuriser votre clé API.

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

Étapes suivantes