Gemini API CLI
Gemini API CLI, annoncé en bêta le 27 octobre 2026, permet à un script ou à un agent d’appeler l’API depuis le terminal. La commande gemini-api ne désigne pas l’agent interactif Gemini CLI : les deux outils ont des rôles différents.
01 Ce que fait le client gemini-api
Le client appelle les modèles et les agents gérés depuis un shell. Le guide donne des usages de génération de texte ou de médias, d’analyse de fichiers et de recherche en arrière-plan via Interactions API. Il est utilisable depuis un script, une chaîne CI ou un agent disposant du terminal.
Il ne remplace pas Gemini CLI, qui est un agent de développement interactif. Installer l’un ne donne pas automatiquement les quotas, les fonctions ou l’abonnement de l’autre. Le CLI client et le modèle choisi sont deux couches distinctes.
02 Des fichiers sur disque et des sorties structurées
Pour les médias, le client écrit les fichiers sur disque et peut afficher les chemins ou des métadonnées au lieu d’injecter les données binaires dans le contexte de l’agent. Le guide prévoit JSON, des schémas et des codes de sortie pour automatiser la gestion des erreurs.
Le fonctionnement est sans état implicite par défaut. Une suite d’actions doit transmettre explicitement les identifiants d’interaction, de fichier ou d’opération d’arrière-plan nécessaires. Ne pas supposer qu’une seconde commande connaît la conversation de la première.
03 Authentification et versions à figer
Le guide prévoit des distributions pour macOS, Linux et Windows ainsi que des archives versionnées. Pour un projet automatisé, préférer une version précise à un téléchargement flottant. L’éditeur prévient que des changements incompatibles peuvent survenir entre versions mineures de cette bêta.
La clé API doit rester dans l’environnement adapté ou le gestionnaire de secrets, jamais dans le dépôt public ni le code navigateur. Vérifier la cible d’un téléchargement et les instructions officielles avant d’exécuter un programme d’installation.
04 Le coût dépend de l’API appelée
Conditions documentées au 29 octobre 2026. Cette fiche ne présente pas le client comme un forfait d’inférence gratuit ou illimité : les modèles, le palier API et les outils conservent leurs propres règles de facturation.
Une clé de projet et une session d’application ne sont pas interchangeables. Consulter la grille du modèle choisi et prévoir un budget pour les outils, les médias et les travaux d’arrière-plan. Aucun montant d’abonnement Gemini CLI n’est réattribué à ce client.
05 Vérifier sans lancer une requête payante
Le guide prévoit un mode --dry-run pour valider les entrées et examiner la requête HTTP préparée, avec masquage des identifiants. Les options --usage et --schema permettent de lire les commandes et leurs paramètres sans dépendre d’exemples anciens.
Avant un déploiement CI, tester les chemins de fichiers, les codes d’erreur et les délais d’attente avec des données non sensibles. Vérifier le fichier produit plutôt que prendre la présence d’une ligne de sortie pour une preuve de génération réussie. Aucun appel payant n’a été effectué pour rédiger cette fiche.
Sources officielles
- Guide officiel : commandes, authentification et limites
- Annonce bêta du 27 octobre 2026
- Facturation des modèles et des outils appelés
Consultées le 29 octobre 2026. Fiche documentaire sur sources éditeur, sans benchmark indépendant ni appel payant de modèle revendiqué.