Connecter une clé API Google Cloud pour Vertex AI

Avant de commencer

Les conditions de Google pour ses services d’IA générative interdisent les services susceptibles d’être utilisés par des mineurs. Réservez les budgets Google aux personnes de 18 ans ou plus : vous le confirmez à la connexion de la clé, puis chaque bénéficiaire confirme son âge lors de l’acceptation ou de la demande.

Une clé Gemini de Google AI Studio est différente, malgré son apparence similaire : ses conditions interdisent de la prêter et ce service n’appelle jamais l’API Gemini. Créez la clé dans la console Google Cloud.

Pour ses modèles récents, Google peut conserver les prompts et les réponses dans votre compte Google Cloud jusqu’à 30 jours à des fins de contrôle de sécurité automatisé. Nous ne stockons ni les prompts ni les réponses.

Créer la clé

Avec un compte @gmail.com, le plus rapide est le mode express de Vertex AI : suivez le guide Google Obtenir une clé API Google Cloud et associez un compte de facturation pour conserver la clé après l’essai.

Dans votre propre projet avec un compte de facturation, créez une clé liée à un compte de service, appelée clé d’autorisation par Google :

1. Dans la console IAM, créez un compte de service pour cette clé et attribuez-lui uniquement le rôle roles/aiplatform.user (Vertex AI User).
2. Ouvrez Credentials, choisissez Create credentials, puis API key.
3. Restreignez la clé à la seule API aiplatform.googleapis.com, l’API Vertex AI.
4. Cochez Authenticate API calls through a service account et sélectionnez le compte de service créé.
5. Créez la clé et copiez-la : elle commence par AIza.

Les organisations récentes bloquent par défaut les clés API de compte de service. Un administrateur doit les autoriser pour aiplatform.googleapis.com avec la règle constraints/iam.managed.disableServiceAccountApiKeyCreation. Guide Google : clés API.

Ou utiliser le fichier de clé d’un compte de service

Si votre organisation interdit de lier une clé API à un compte de service, fournissez à Tokens On Me le fichier JSON de clé du compte de service. Google rappelle le risque lié à ces fichiers : leur détenteur peut agir comme le compte de service jusqu’à révocation de la clé. Tokens On Me l’utilise uniquement pour demander à Google un jeton d’accès valable une heure, conservé uniquement en mémoire.

1. Dans la console IAM, créez un compte de service pour ce fichier et attribuez-lui uniquement le rôle roles/aiplatform.user (Vertex AI User).
2. Ouvrez le compte de service, puis l’onglet Keys. Choisissez Add key puis Create new key, avec JSON comme type : le fichier est téléchargé et Google ne le fournira plus ensuite.
3. Collez le fichier complet tel quel dans le champ de clé de l’écran des clés, puis supprimez la copie téléchargée.

Si la règle iam.disableServiceAccountKeyCreation s’applique, comme par défaut dans les organisations créées depuis 2024, aucun fichier de clé ne peut être créé avant intervention d’un administrateur. Guide Google : créer et supprimer des clés de compte de service.

Définir un budget

Les budgets Google Cloud vous alertent et leurs plafonds peuvent suspendre Vertex AI, mais sans agir en temps réel : Google précise que le blocage n’est pas immédiat et que les dépassements restent facturés. Tokens On Me réserve un montant sur chaque budget avant chaque requête et vérifie que le solde peut couvrir cette réservation.

1. Dans Budgets & alerts, créez un budget mensuel pour le projet de la clé, avec une alerte e-mail.

Connecter la clé

1. Connectez-vous, ouvrez Clés fournisseur, collez la clé sous Google Vertex AI, confirmez que les bénéficiaires ont 18 ans ou plus et enregistrez.
2. Créez un budget dans Budgets et choisissez cette clé fournisseur.

Couper l’accès

Dans Credentials, supprimez la clé ; pour un fichier de clé, supprimez la clé dans l’onglet Keys du compte de service. Vertex AI refusera ensuite les requêtes l’utilisant, mais un jeton d’accès déjà émis peut rester valable jusqu’à la fin de son heure. La déconnexion dans l’écran des clés bloque immédiatement les nouvelles requêtes via ce service.