Avec Gemini Enterprise Agent Platform en mode Express, vous pouvez vous inscrire et commencer à créer des applications d'IA générative sur Cloud de Confiance by S3NS. Cette expérience de configuration simplifiée facilite l'accès aux Cloud de Confiance API en simplifiant l'organisation, la facturation et la gestion de projet.
Pour en savoir plus sur Agent Platform en mode Express, consultez la FAQ sur le mode Express de Google Cloud.
S'inscrire au mode Express
Agent Platform est disponible en mode Express pour les développeurs disposant d'un
@gmail.com compte Google :
Nouveaux utilisateurs : les nouveaux utilisateurs de Cloud de Confiance peuvent s'inscrire à un compte en mode Express dans un niveau sans frais pour essayer Agent Platform sans frais pendant 90 jours maximum, dans les limites 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 frais et n'est pas disponible via celui-ciCloud de Confiance Free Program. Si vous participez au Cloud de Confiance programme sans frais, consultez les autres guides de démarrage rapide dans la section Premiers pas.
Pour vous inscrire à Agent Platform en mode Express, ouvrez Mode Express dans la Cloud de Confiance console :
Une fois la configuration terminée, vous pouvez commencer à utiliser Agent Platform en mode Express en suivant l'un des tutoriels suivants :
En savoir plus sur Agent Platform en mode Express
Lorsque vous vous inscrivez au mode Express, Cloud de Confiance active les API en votre nom. Ce processus s'effectue 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 requêtes pour différents modèles d'IA générative, et obtenez le code correspondant à utiliser dans votre application.
- Une clé API. Authentifiez les requêtes de votre application.
- Niveau sans frais pour les nouveaux Cloud de Confiance utilisateurs pendant 90 jours. Pendant la limite de 90 jours du niveau sans frais pour les nouveaux Cloud de Confiance utilisateurs, 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 existant Cloud de Confiance 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 supplémentaires Cloud de Confiance . Lorsque vos quotas sont augmentés, vous ne payez que ce que vous utilisez. Vous pouvez à tout moment choisir de quitter le mode Express et de commencer à utiliser tous les Cloud de Confiance services et fonctionnalités.
Le tableau suivant présente les différences entre les expériences en mode Express et l'expérience complète d'Agent Platform :
| É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 Cloud de Confiance services, y compris Agent Platform. |
| Sources de données | Google Drive | Toutes les sources de données disponibles dans Cloud de Confiance. |
| Quota | Limites du niveau sans frais. Consultez la section Modèles disponibles et limites de débit en mode Express. | Limites standards du paiement à l'utilisation. Consultez la section Limites de débit. |
| 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). 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 listé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
Cloud de Confiance console en mode Express. Pour utiliser
les modèles d'API Gemini Live compatibles,
passez du mode Express à un compte standard Cloud de Confiance.
Workflow d'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 essayer 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'interface utilisateur.
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 par programmation les mêmes requêtes que celles que vous avez implémentées dans l'interface utilisateur. Vous pouvez obtenir le code pour un langage de programmation ou curl. Vous pouvez utiliser Google Colab pour essayer le code Python.
Utilisez votre clé API pour vous authentifier auprès de l'API Agent Platform.
Dans la Cloud de Confiance console en mode Express, ouvrez API et services > Identifiants :
Copiez ensuite votre clé API Generative Language dans votre code à l'endroit où il est indiqué
"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).
Différences en mode Express
Agent Platform en mode Express fournit un sous-ensemble des fonctionnalités d'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 d'Agent Platform en mode Express.
De plus, les clients dans Cloud de Confiance 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 pouvez les voir mentionnés dans une partie de la Cloud de Confiance documentation 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 |
Lorsque vous envoyez des requêtes REST en mode Express, gardez à l'esprit les détails suivants concernant le point de terminaison et l'authentification :
- Chemin d'accès au modèle de l'éditeur (
{model}) : dans la documentation de référence de l'API REST d'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 l'éditeur (publishers/google/models/MODEL_ID). Les deux renvoient à la même URL de point de terminaison. - En-tête d'authentification de la clé API : il n'est pas obligatoire 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 à la place le paramètre de requête systèmekey(?key=API_KEY). Pour en savoir plus, consultez la section 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 qui a été créée pour vous lors de votre inscription ou toute autre clé que vous avez créée en mode Express. Une clé API est une chaîne chiffrée générée automatiquement pour vous 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 la section Bonnes pratiques de gestion des clés API.
Pour afficher et gérer vos clés API, procédez comme suit :
Dans la Cloud de Confiance console, 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.
Une fois la facturation activée, vous ne payez que ce que vous utilisez. Vous pouvez également enregistrer vos requêtes et utiliser des paramètres supplémentaires dans la Cloud de Confiance console 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 Cloud de Confiance console en mode Express, ouvrez Facturation:
Gérez vos comptes de facturation.
Commencer à utiliser toutes les Cloud de Confiance by S3NS fonctionnalités et tous les services
Le mode Express est conçu pour vous aider à démarrer. Lorsque vous êtes prêt à utiliser d'autres Cloud de Confiance services ou que vous avez besoin de mieux contrôler votre environnement, vous pouvez passer votre compte en mode Express à un compte standard Cloud de Confiance Ce processus est parfois appelé mise à niveau.
Vous pouvez commencer à utiliser toutes les fonctionnalités et tous les services disponibles dans Cloud de Confiance dans votre projet en mettant à niveau votre compte en mode Express.
Pour passer du mode Express, 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.
Une fois que vous avez effectué la mise à niveau depuis le mode Express, spécifiez l'ID de votre projet et votre 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