Obtenir une clé API Google Cloud

Pour utiliser Gemini sur Vertex AI, vous devez vous authentifier à l'aide d'une clé APIGoogle Cloud ou des identifiants par défaut de l'application. Nous vous recommandons d'utiliser une clé API pour les tests et les identifiants par défaut de l'application pour la production. Cette page vous explique comment obtenir une clé API Google Cloud en fonction de votre possession ou non d'un compte Google Cloud .

Indiquez si vous disposez d'un compte Google Cloud :

Créer une clé API Google Cloud

Si vous disposez déjà d'un compte Google Cloud , suivez les instructions ci-dessous pour obtenir une clé API Google Cloud standard. Vous pouvez également utiliser les identifiants par défaut de l'application au lieu d'une clé API.

Avant de commencer

Sélectionner un projet, activer la facturation et activer l'API Vertex AI

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Activer la création de clés API de compte de service

  1. Ouvrez IAM et administration > Règles d'administration.
  2. Dans la liste des règles, recherchez les règles appelées iam.managed.disableServiceAccountApiKeyCreation.
  3. Cliquez sur Actions > Modifier la stratégie.
  4. Sous Source de la règle, sélectionnez Remplacer la règle parente, puis cliquez sur Ajouter une règle.
  5. Sous Application, sélectionnez Désactivé.
  6. Cliquez sur OK.
  7. Cliquez sur Définir la règle. Dans la boîte de dialogue qui s'affiche, cliquez de nouveau sur Définir une stratégie.

Créer un compte de service

  1. Ouvrez IAM et administration > Comptes de service.
  2. Cliquez sur Créer un compte de service.
  3. Configurez le compte de service comme suit :
    • Service account name (Nom du compte de service) : vertex-ai-runner
    • Service account ID (ID du compte de service) : vertexairunner
  4. Cliquez sur Créer et continuer.
  5. Sous Autorisations, cliquez sur Sélectionner un rôle, puis sélectionnez Utilisateur de Vertex AI Platform Express dans le menu.
  6. Cliquez sur Continuer.
  7. Cliquez sur OK.

Créer une clé API

  1. Ouvrez API et services > Identifiants.
  2. Cliquez sur Créer des identifiants > Clé API.
  3. Configurez la clé API comme suit :
    • Nom : vertexaiapikey
    • Authentifier les appels d'API via un compte de service: sélectionné.
  4. Cliquez sur Sélectionner un compte de service.
  5. Sélectionnez le compte de service que vous avez créé à l'étape précédente, puis cliquez sur Sélectionner.
  6. Cliquez sur Créer.

Envoyer votre première requête API

Après avoir obtenu une clé API, découvrez comment l'utiliser pour effectuer votre première requête dans le guide de démarrage rapide de l'API.

Facultatif: Configurer votre clé API localement

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.

Cliquer pour développer les instructions

Linux/macOS

  1. Exécutez la commande suivante pour voir quel shell de ligne de commande vous utilisez:

    echo $SHELL

    Le résultat ressemble à ce qui suit :

    /bin/bash

  2. Ajoutez une variable d'exportation de shell pour votre clé API en effectuant l'une des opérations suivantes:

    • Si le résultat de l'étape précédente est /bin/bash:

      1. Ouvrez .bashrc :

        touch ~/.bashrc
        open ~/.bashrc

      2. Ajoutez la ligne suivante au fichier .bashrc :

        export GEMINI_API_KEY=YOUR_API_KEY

      3. Enregistrez le fichier, puis exécutez la commande suivante pour appliquer les modifications:

        source ~/.bashrc

    • Si le résultat de l'étape précédente est /bin/zsh:

      1. Ouvrez .zshrc :

        touch ~/.zshrc
        open ~/.zshrc

      2. Ajoutez la ligne suivante au fichier .zshrc :

        export GEMINI_API_KEY= YOUR_API_KEY

      3. Enregistrez le fichier, puis exécutez la commande suivante pour appliquer les modifications:

        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_API_KEY
  4. Appliquer les modifications