Comment Utiliser l'API Gemini 3.0

Les développeurs recherchent constamment des modèles d'IA puissants sans encourir de coûts élevés. Google répond à ce besoin en offrant un accès gratuit à des modèles avancés, y compris des versions préliminaires comme Gemini 3 Pro.

💡

Avant de continuer, téléchargez Apidog gratuitement dès maintenant – il constitue un excellent client API pour envoyer des requêtes à l'API Gemini 3, inspecter les réponses, gérer les entrées multimodales et déboguer efficacement les points d'accès lors de vos expérimentations sur le niveau gratuit.

bouton

Google maintient un niveau gratuit généreux pour l'API Gemini via Google AI Studio. Cette configuration vous permet de générer une clé API et de commencer à appeler des modèles immédiatement. De plus, à partir de novembre 2025, Google offre un accès gratuit aux modèles de prévisualisation Gemini 3 Pro, bien qu'avec des limites de débit adaptées au prototypage, aux tests et aux applications à petite échelle.

Comprendre la tarification de l'API Gemini 3

Généralement, la tarification de Gemini 3.0 se présente comme suit :

<200k jetons : 2,00 $ en entrée, 12,00 $ en sortie
>200k jetons : 4,00 $ en entrée, 18,00 $ en sortie

La date de coupure des connaissances de Gemini 3.0 est fixée à janvier 2025.

Si vous souhaitez utiliser l'API Gemini 3.0 gratuitement, Google est assez généreux pour vous laisser essayer : Google structure l'API Gemini autour de deux niveaux principaux : gratuit et paiement à l'usage. Le niveau gratuit fonctionne entièrement sans activation de facturation. Par conséquent, toutes les requêtes restent gratuites tant que vous n'activez pas explicitement la facturation Cloud pour des quotas plus élevés.

Google AI Studio fonctionne comme l'interface principale pour l'accès gratuit. Ici, vous prototypez des invites, générez des clés API et appelez des modèles directement. Les modèles de prévisualisation comme Gemini 3 Pro apparaissent automatiquement dans le sélecteur de modèles lorsqu'ils sont disponibles dans votre région.

Les principaux avantages du niveau gratuit incluent :

Aucune carte de crédit requise
Accès aux modèles de prévisualisation de pointe, y compris Gemini 3 Pro
Prise en charge des entrées multimodales (texte, images, vidéo, audio)
Appel de fonction, sorties structurées et outils d'exécution de code
Limites de débit réinitialisées quotidiennement, suffisantes pour le développement et une utilisation modérée en production

Cependant, le niveau gratuit applique des quotas pour garantir une utilisation équitable. Les limites typiques pour les modèles de prévisualisation Gemini 3 Pro sont d'environ 5 à 10 requêtes par minute (RPM), 250 000 jetons par minute (TPM) et 50 à 100 requêtes par jour (RPD). Ces valeurs varient selon la variante du modèle et la région, et Google les ajuste périodiquement.

Étape par étape : Générez votre clé API Gemini 3

Vous commencez par créer une clé API dans Google AI Studio. Suivez ces étapes précises :

Accédez à aistudio.google.com.
Connectez-vous avec votre compte Google (personnel ou Workspace).

4. Cliquez sur l'icône de profil en haut à droite et sélectionnez "Obtenir une clé API". Choisissez "Créer une clé API dans un nouveau projet" (ou sélectionnez-en un existant).

6. Google génère la clé instantanément. Copiez-la immédiatement – vous ne pourrez plus la visualiser.

De plus, vous pouvez créer plusieurs clés et les restreindre à des référents ou des adresses IP spécifiques pour la sécurité. Traitez toujours la clé comme une donnée sensible ; ne la mettez jamais dans des dépôts publics.

Pour un accès direct à la prévisualisation de Gemini 3 Pro, visitez ce lien fourni par Google : https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview. Cela ouvre une interface de chat préconfigurée avec le modèle de prévisualisation.

Essayons l'API Gemini 3.0 dans Google AI Studio

Installer les SDK officiels de Gemini pour un accès programmatique

Google fournit des bibliothèques clientes dans plusieurs langages. Vous les installez via des gestionnaires de paquets.

Pour les développeurs Python :

pip install -U google-generativeai

Ensuite, configurez la bibliothèque :

import google.generativeai as genai

genai.configure(api_key="VOTRE_CLÉ_API_ICI")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content("Expliquez l'intrication quantique en termes simples.")
print(response.text)

Les utilisateurs de Node.js exécutent :

npm install @google/generative-ai

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("VOTRE_CLÉ_API_ICI");
const model = genAI.getGenerativeModel({ model: "gemini-3-pro-preview-11-2025" });

const result = await model.generateContent("Écrivez une fonction Python pour calculer les nombres de Fibonacci.");
console.log(result.response.text());

Les autres langages pris en charge incluent Go, Java et Swift. Toutes les bibliothèques gèrent automatiquement l'authentification, les tentatives et le streaming.

Envoyer votre première requête à l'API Gemini 3 en utilisant curl

Vous pouvez tester directement avec curl pour une vérification rapide :

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview-11-2025:generateContent?key=YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Décrivez les améliorations clés de Gemini 3 par rapport aux versions précédentes." }]
    }]
  }'

Ce point d'accès renvoie une réponse JSON contenant le texte généré et les métadonnées d'utilisation.

Utiliser Apidog pour un flux de travail de test API meilleur et plus intégré

Les commandes curl brutes fonctionnent pour des tests simples, mais le développement de qualité production exige de meilleurs outils. Apidog excelle ici en tant que client API complet et plateforme de documentation.

bouton

Vous importez la spécification OpenAPI officielle de Gemini dans Apidog, qui génère automatiquement tous les points d'accès, paramètres et corps de requête. Par la suite, vous :

Enregistrez votre clé API comme variable d'environnement
Créez des collections pour différents cas d'utilisation (génération de texte, vision, appel de fonction)
Envoyez des requêtes multimodales en téléchargeant directement des images ou des vidéos
Visualisez l'utilisation des jetons et les métadonnées de réponse en temps réel
Générez du code client (Python, JS, etc.) à partir de requêtes réelles
Configurez des serveurs de maquette pour les tests front-end sans consommer de quota

L'interface d'Apidog pour tester les points d'accès de l'API Gemini 3

De nombreux développeurs choisissent Apidog spécifiquement pour les flux de travail Gemini car il gère de manière transparente les téléchargements de fichiers volumineux, les réponses en streaming et les sorties JSON structurées – des fonctionnalités avec lesquelles Postman a du mal pour les API génératives.

Quels sont les plafonds d'utilisation de l'API Gemini 3.0 ?

Google ne divulgue pas actuellement les plafonds d'utilisation de l'API Gemini 3.0, bien que des utilisateurs signalent qu'ils subissent des limites de débit après quelques conversations (Code d'erreur : Vous avez atteint votre limite de débit. Veuillez réessayer plus tard).

Selon la documentation officielle de Google, l'API Gemini dispose d'un niveau gratuit accessible via Google AI Studio qui est soumis à des plafonds d'utilisation pour garantir une utilisation équitable. Ces limites sont principalement mesurées en Requêtes Par Minute (RPM), et pour certains modèles, également en Requêtes Par Jour (RPD) et en Jetons Par Minute (TPM). Par exemple, le modèle standard gemini-1.0-pro a une limite de débit gratuite de 60 RPM, ce qui est généralement suffisant pour le développement et les tests. Ces limites sont fournies gratuitement et ne nécessitent pas la configuration d'un compte de facturation.

Différents modèles au sein de la famille Gemini ont des plafonds d'utilisation différents. Dépasser la limite de débit d'un modèle entraînera une erreur HTTP 429 "Resource Exhausted". Pour gérer cela, les développeurs doivent implémenter une gestion des erreurs avec une stratégie de backoff exponentiel, qui implique d'attendre des périodes de plus en plus longues avant de retenter une requête. Pour les applications nécessitant un volume de requêtes plus élevé que ce que le niveau gratuit permet, vous devez activer la facturation sur un projet Google Cloud et passer au plan de paiement à l'usage, qui offre des limites significativement plus élevées (ai.google.dev).

Pour un débit plus élevé, vous créez plusieurs comptes Google (chacun avec sa propre clé) et les faites pivoter – une pratique courante chez les développeurs qui restent dans les limites gratuites.

Vision et vidéo avec l'API Gemini 3.0

Gemini 3 traite les images et les vidéos nativement. Exemple de code Python pour l'analyse d'images :

from google.generativeai.types import File

image_file = genai.upload_file(path="diagram.png")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content([
    "Expliquez ce diagramme d'architecture en détail :",
    image_file
])
print(response.text)

La compréhension vidéo fonctionne de manière similaire – téléchargez un MP4 et posez des questions sur le contenu, les horodatages ou les actions.

Conclusion

Google permet un accès sans précédent à l'IA de pointe grâce à son niveau gratuit. Vous obtenez une clé en moins de deux minutes, commencez à appeler immédiatement les modèles de prévisualisation Gemini 3 Pro et construisez des applications sophistiquées sans dépenser d'argent.

Combinez cette capacité avec un client API robuste comme Apidog, et vous obtenez un environnement de développement complet rivalisant avec les services payants. Des milliers de développeurs prototypent déjà des agents, des systèmes RAG et des applications multimodales de cette manière.

Agissez maintenant : rendez-vous sur Google AI Studio, générez votre clé, téléchargez Apidog et envoyez votre première requête Gemini 3. La barrière à la construction avec l'IA de pointe n'a jamais été aussi basse.

bouton