Avec Gemini Enterprise Agent Platform en mode Express, vous pouvez vous inscrire et commencer à créer des applications d'IA générative sur Google Cloud. Cette expérience de configuration simplifiée facilite l'accès aux API Google Cloud en simplifiant la gestion de l'organisation, de la facturation et des projets.
Pour en savoir plus sur Agent Platform en mode Express, consultez les questions fréquentes sur le mode Express deGoogle Cloud.
S'inscrire au mode Express
Agent Platform est disponible en mode Express pour les développeurs disposant d'un compte Google@gmail.com :
Nouveaux utilisateurs : les nouveaux utilisateurs de Google Cloud peuvent créer un compte en mode Express dans un niveau sans frais pour essayer Agent Platform sans frais pendant 90 jours, dans la limite des quotas spécifiés. Vous n'avez pas besoin de fournir d'informations de facturation pour vous inscrire au niveau sans frais. Vous pouvez passer à un niveau payant en ajoutant un compte de facturation.
Agent Platform en mode Express est distinct du programme sans fraisGoogle Cloud et n'est pas disponible par son biais. Si vous participez au programme sans fraisGoogle Cloud , consultez les autres guides de démarrage rapide de la section Premiers pas.
Pour vous inscrire à Agent Platform en mode Express, ouvrez le mode Express depuis la console Google Cloud :
Une fois la configuration terminée, vous pouvez commencer à utiliser Agent Platform en mode Express en suivant l'un des tutoriels :
En savoir plus sur Agent Platform en mode Express
Lorsque vous vous inscrivez au mode Express, Google Cloud active les API en votre nom. Ce processus se déroule en arrière-plan. Vous pouvez donc commencer à utiliser Agent Platform sans avoir à configurer manuellement les ressources.
Lorsque vous vous inscrivez au mode express, vous avez accès aux éléments suivants :
- Fonctionnalités principales d'Agent Studio Testez et personnalisez des prompts pour différents modèles d'IA générative, et obtenez le code correspondant à utiliser dans votre application.
- Une clé API. Authentifier les requêtes de votre application.
- Niveau sans frais pour les nouveaux utilisateurs de Google Cloud pendant 90 jours. Pendant la limite de 90 jours du niveau sans frais pour les nouveaux utilisateurs de Google Cloud , vous pouvez utiliser les API Agent Platform compatibles avec le mode Express sans frais, dans la limite de leurs quotas. Vous n'avez pas besoin de fournir d'informations de facturation. Vous pouvez augmenter les limites de vos quotas à tout moment en activant la facturation.
Si vous êtes un utilisateur Google Cloud existant ou après avoir activé la facturation, le niveau sans frais de 90 jours est supprimé. Vous passez à un niveau payant pour accéder à des limites de quota étendues et à des fonctionnalités Google Cloud supplémentaires. Vos quotas sont augmentés, et vous ne payez que ce que vous utilisez. Vous pouvez à tout moment quitter le mode Express et commencer à utiliser tous les services et fonctionnalités Google Cloud .
Le tableau suivant présente les différences entre les expériences en mode express et l'expérience complète de la plate-forme d'agent :
| Élément | Mode Express d'Agent Platform dans le niveau sans frais | Agent Platform complet |
|---|---|---|
| Délai | 90 jours | Illimité |
| Services disponibles | Services d'IA générative de base. | Tous les services Google Cloud , y compris Agent Platform. |
| Sources de données | Google Drive | Toutes les sources de données disponibles dans Google Cloud. |
| Quota | Limites du niveau sans frais. Consultez Modèles disponibles et limites de débit en mode express. | Limites standards du paiement à l'usage. Consultez la page Limites de débit pour en savoir plus. |
| Format standard des points de terminaison de l'API | Utilisez le point de terminaison global sans ID de projet ni emplacement, et transmettez votre clé API dans l'en-tête HTTP x-goog-api-key (ou le paramètre de requête key). Par exemple :https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent
|
Spécifiez un ID de projet et un emplacement. Par exemple :https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
|
Modèles disponibles et limites de débit en mode Express
Vous pouvez essayer plusieurs modèles en mode express, y compris les modèles Gemini Flash. Le tableau suivant répertorie les modèles disponibles en mode express, ainsi que leurs limites de débit :
| Catégorie de modèle | Modèles disponibles | Nombre maximal de requêtes par minute |
|---|---|---|
| Gemini | gemini-3-pro-image |
Dynamique |
gemini-3.1-flash-image |
Dynamique | |
gemini-3.1-pro-preview |
Dynamique | |
gemini-3-flash-preview |
Dynamique | |
gemini-2.5-pro |
10 | |
gemini-2.5-flash-image |
10 | |
gemini-2.5-flash |
10 | |
gemini-2.5-flash-lite |
10 |
Seuls les modèles répertoriés dans le tableau précédent sont compatibles avec le mode Express.
Les modèles d'API Gemini Live dédiés, tels que Gemini 3.8 Live (gemini-3.8-live) et Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio), ne sont pas compatibles avec le mode Express, et l'API Gemini Live n'est pas disponible dans la consoleGoogle Cloud en mode Express. Pour utiliser les modèles d'API Gemini Live compatibles, passez du mode Express à un compte Google Cloudstandard.
Workflow Agent Platform en mode express
Vous pouvez commencer à envoyer des requêtes de votre application aux API Agent Platform en trois étapes :
Après vous être inscrit au mode express, utilisez Agent Studio pour tester les fonctionnalités d'Agent Platform :
Par exemple, sélectionnez Agent Studio > Créer un prompt pour créer et optimiser des prompts multimodaux à l'aide de différents modèles Gemini.
Obtenez le code de ce que vous avez implémenté avec l'UI.
Sur la page de la requête, cliquez sur Créer avec du code > Obtenir le code. Un panneau s'ouvre et affiche le code qui envoie de manière programmatique les mêmes requêtes que celles que vous avez implémentées dans l'UI. Vous pouvez obtenir le code pour un langage de programmation ou curl. Vous pouvez utiliser Google Colab pour tester le code Python.
Utilisez votre clé API pour vous authentifier auprès de l'API Agent Platform.
Dans la console Google Cloud en mode express, ouvrez API et services > Identifiants :
Ensuite, copiez votre clé API Generative Language dans votre code à l'emplacement
"YOUR_API_KEY". Exemple :Python
Le SDK Google Gen AI pour Python est disponible sur PyPI et GitHub :
Pour en savoir plus, consultez la documentation de référence sur le SDK Python (s'ouvre dans un nouvel onglet).
Ce qui change en mode Express
Agent Platform en mode Express fournit un sous-ensemble des fonctionnalités pour l'IA générative. Par conséquent, une partie de la documentation d'Agent Platform n'est pas pertinente si vous vous êtes inscrit en mode Express. Pour en savoir plus sur les points de terminaison d'API disponibles en mode express, consultez la documentation de référence de l'API REST de la plate-forme d'agents en mode express.
De plus, les clients de Google Cloud utilisent généralement des organisations et des projets pour travailler avec des ressources (par exemple, pour appeler un point de terminaison d'API). Lorsque vous utilisez Agent Platform en mode express, vous n'avez pas à vous soucier des organisations ni des projets. Toutefois, vous les verrez peut-être mentionnés dans une partie de la documentation Google Cloud que vous consultez lorsque vous utilisez Agent Platform en mode Express. Vous pouvez toujours utiliser la documentation, mais ignorez les concepts et les instructions qui font référence aux organisations et aux projets. De plus, l'emplacement que vous avez sélectionné lors de votre inscription en mode express est utilisé tout au long de votre expérience.
Lorsque vous appelez des points de terminaison d'API REST en mode express, utilisez le format de point de terminaison global pour le mode express et authentifiez-vous avec votre clé API :
| URL du point de terminaison standard | https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent |
| URL du point de terminaison en mode express | https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent |
Tenez compte des informations de point de terminaison et d'authentification suivantes lorsque vous envoyez des requêtes REST en mode express :
- Chemin d'accès au modèle de diffuseur (
{model}) : dans la documentation de référence de l'API REST Agent Platform en mode express, les modèles de point de terminaison tels quehttps://aiplatform.googleapis.com/v1/{model}:streamGenerateContentethttps://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContentutilisent{model}pour représenter le chemin d'accès complet à la ressource du modèle de diffuseur (publishers/google/models/MODEL_ID). Les deux se résolvent en la même URL de point de terminaison. - En-tête d'authentification par clé API : il n'est pas nécessaire de transmettre votre clé API en tant que paramètre de requête. Transmettez votre clé API dans l'en-tête HTTP
x-goog-api-key(par exemple,-H "x-goog-api-key: API_KEY"). Si votre environnement client ne vous permet pas de définir des en-têtes HTTP, vous pouvez transmettre le paramètre de requête systèmekeyà la place (?key=API_KEY). Pour en savoir plus, consultez Utiliser des clés API.
Afficher et gérer les clés API
Pour vous authentifier auprès des points de terminaison de l'API Agent Platform compatibles avec le mode Express, utilisez la clé API créée pour vous lors de l'inscription ou toute clé que vous avez créée en mode Express. Une clé API est une chaîne chiffrée générée automatiquement lorsque vous vous inscrivez en mode Express. Vous pouvez afficher et gérer ces clés API sur la page API et services.
Pour en savoir plus sur les bonnes pratiques de gestion des clés API, consultez Bonnes pratiques de gestion des clés API.
Pour afficher et gérer vos clés API, procédez comme suit :
Dans la console Google Cloud , accédez à la page Clés API :
Activer et gérer la facturation
Vous pouvez augmenter vos quotas et supprimer la limite de 90 jours en activant la facturation.
Après avoir activé la facturation, vous ne payez que ce que vous utilisez. Vous pouvez également enregistrer vos prompts et utiliser des paramètres supplémentaires dans la console Google Cloud qui sont grisés lorsque la facturation n'est pas activée.
Pour gérer la facturation, procédez comme suit :
Accédez à la page de présentation d'Agent Studio en mode Express.
Dans la console Google Cloud en mode express, ouvrez Facturation :
Gérez vos comptes de facturation.
Commencez à utiliser toutes les fonctionnalités et tous les services Google Cloud
Le mode Express est conçu pour vous aider à démarrer. Lorsque vous êtes prêt à utiliser d'autres servicesGoogle Cloud ou que vous avez besoin de mieux contrôler votre environnement, vous pouvez passer d'un compte en mode Express à un compte Google Cloud standard. Ce processus est parfois appelé mise à niveau.
Vous pouvez commencer à utiliser toutes les fonctionnalités et tous les services disponibles dansGoogle Cloud dans votre projet en mettant à niveau votre compte en mode Express.
Pour passer du mode express au mode avancé, procédez comme suit :
Accédez à la page de présentation d'Agent Studio en mode Express.
Cliquez sur Activer maintenant, puis suivez les instructions.
Après avoir effectué la mise à niveau à partir du mode Express, spécifiez l'ID de votre projet et l'emplacement au lieu de votre clé API lorsque vous appelez les points de terminaison de l'API REST. Exemple :
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent