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 vérifier votre configuration à l'aide d'une commande curl. Vous pouvez transmettre la clé API dans l'URL:

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 éléments à garder à l'esprit lorsque vous utilisez votre clé API Gemini:

  • L'API Gemini de Google AI utilise des clés API pour l'autorisation. Si d'autres personnes y ont accès à votre clé API Gemini, ils peuvent passer 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é). Les clés API protègent é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 affiche toutes les clés API qu'AI Studio a provisionnées pour être utilisées avec l'API l'API Gemini AI (ainsi que tous les projets Google Cloud associés).

    • Cependant, toutes les clés API du projet Google Cloud peuvent être utilisé pour appeler l'API Gemini de Google AI. Vous pouvez afficher et gérer toutes vos clés API du projet dans API et Services > Panneau "Credentials" (Identifiants) dans la console Google Cloud.

  • Ajout... Restrictions liées aux clés API peut permettre de limiter la surface utilisable via 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'IA de Google l'API Gemini (officiellement appelée "API Generative Language" ou generativelanguage.googleapis.com).

    • Si des clés API de votre projet Google Cloud n'ont pas d'API des restrictions ou des clés API pour lesquelles Generative Language a été ajouté à la liste d'autorisation ces clés peuvent être utilisées avec l'API Gemini de Google AI. Il est préférable de vous entraîner à limiter chaque clé API aux seules API que vous appelez à l'aide de ce .
    • Notez que même avec des restrictions de clés API, si un individu malveillant obtient votre la clé API, il peut l'utiliser pour effectuer des appels en utilisant le quota de votre projet 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 vérifiez PAS les clés API Gemini dans le contrôle du code source.
    • Risques liés aux applications côté client (Android, Swift, Web et Dart/Flutter) les clés API. Par conséquent, nous vous déconseillons d'utiliser les SDK clients de l'IA de Google en production pour appeler l'API Gemini de Google AI directement depuis votre dans les applications mobiles et Web. Consultez les guides de démarrage rapide des SDK pour en savoir plus les bonnes pratiques propres à chaque langage pour sécuriser votre clé API.

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

Étapes suivantes