Accueil / Guides / Gemini CLI avec un point de terminaison personnalisé et des modèles gratuits

Gemini CLI avec un point de terminaison personnalisé et des modèles gratuits

Gemini CLI est l'agent de développement open source de Google, pour le terminal. Il peut envoyer ses requêtes vers une URL de base personnalisée. Ce guide dirige Gemini CLI vers FreeLLMAPI, qui sert l'API Gemini native sur /v1beta. Vos requêtes vont alors vers votre ensemble d'offres gratuites, qui peut inclure des clés gratuites de l'API Gemini.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

Le changement de l'offre gratuite de Gemini CLI en 2026

Lisez d'abord ce point. Google a modifié l'usage gratuit de Gemini CLI en 2026. La page des quotas de Gemini CLI indique : « Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026. »

L'annonce de Google indique que Gemini CLI reste disponible avec des clés payantes de l'API Gemini et pour les clients entreprise.

  • Connexion Google dans l'offre gratuite : n'est plus proposée par Gemini CLI pour les comptes grand public.
  • Clé de l'API Gemini avec une URL de base personnalisée : la référence de configuration de Gemini CLI documente toujours GOOGLE_GEMINI_BASE_URL. Avec cette variable, Gemini CLI envoie ses requêtes à l'URL que vous définissez, et non à Google.
  • Clés gratuites de l'API Gemini : Google AI Studio propose toujours une offre gratuite pour l'API Gemini. FreeLLMAPI peut utiliser ces clés, avec des clés d'autres fournisseurs.

Ce guide utilise la seconde méthode. FreeLLMAPI répond aux requêtes et envoie chacune d'elles à un modèle gratuit de votre ensemble.

Étape 1 : installer FreeLLMAPI et Gemini CLI

Installer les deux

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

Ouvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Une clé gratuite Google AI Studio est un bon premier choix. Copiez votre clé unifiée sur cette même page.

Étape 2 : diriger Gemini CLI vers la passerelle

Définissez deux variables d'environnement, puis démarrez Gemini CLI. L'URL de base est l'origine du serveur, sans /v1beta. Gemini CLI ajoute lui-même le chemin de l'API.

macOS ou Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Lorsque Gemini CLI demande une méthode d'authentification, sélectionnez Use Gemini API key. Pour enregistrer ce choix, définissez-le dans ~/.gemini/settings.json :

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Important : utilisez GEMINI_API_KEY. Un ticket de Gemini CLI signale que la version 0.44.x échoue avec « Invalid auth method selected » lorsque GOOGLE_API_KEY est utilisée avec GOOGLE_GEMINI_BASE_URL. Si GOOGLE_API_KEY est définie, supprimez-la avec unset GOOGLE_API_KEY.

Étape 3 : faire correspondre les noms de modèles Gemini aux modèles gratuits

Gemini CLI demande des noms de modèles Gemini, par exemple gemini-2.5-flash. FreeLLMAPI n'envoie pas directement ces noms à Google. Il les résout grâce à la table de correspondance des familles Gemini, dans l'onglet Keys, Agents. Associez chaque famille (Pro, Flash et Flash-Lite) à Auto ou à un modèle épinglé du catalogue.

  • Avec Auto, le routeur sélectionne un modèle gratuit pour chaque requête. Lorsqu'un fournisseur renvoie une erreur 429, il essaie le suivant.
  • Les identifiants du catalogue fonctionnent aussi comme noms de modèles. Démarrez Gemini CLI avec gemini -m <catalog-id>, ou définissez GEMINI_MODEL.
  • Gemini CLI est un agent qui utilise des outils. Associez les familles à des modèles qui prennent en charge l'appel d'outils et disposent d'une grande fenêtre de contexte.

Le premier tableau présente les modèles Gemini gratuits du catalogue actuel. Le second tableau présente d'autres modèles gratuits que vous pouvez associer à une famille Gemini.

Modèles gratuits de l'API Gemini avec appel d'outils (Google AI Studio)
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.5 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.8 LiveGoogle AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.5 Flash LiteGoogle AI Studio1M15 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui

Affichage de 8 modèles gratuits sur 14 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Autres modèles gratuits pour Gemini CLI : appel d'outils et 128K+ de contexte
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui

Affichage de 8 modèles gratuits sur 104 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Limites de l'offre gratuite Gemini

La page des limites de débit de Google indique que les limites s'appliquent par projet, et non par clé d'API. Plusieurs clés dans un même projet ne donnent pas plus de quota. Google indique aussi que les limites ne sont pas garanties, et que vous pouvez consulter vos limites actuelles dans Google AI Studio. Les modèles en préversion ont des limites plus basses.

Une clé gratuite pour Gemini Flash permet peu de requêtes par jour. Une seule tâche de Gemini CLI peut envoyer de nombreuses requêtes. Ajoutez des clés d'autres fournisseurs, afin que le routeur puisse continuer lorsque le quota Gemini est épuisé. La surface native prend en charge generateContent, streamGenerateContent avec ?alt=sse, countTokens et la liste des modèles.

FreeLLMAPI accepte la clé dans l'en-tête x-goog-api-key, comme jeton Bearer, ou dans le paramètre de requête ?key= de Gemini. Privilégiez un en-tête, car une clé dans une URL peut apparaître dans l'historique du shell et dans les journaux du proxy.

Dépannage

ProblèmeCauseSolution
Gemini CLI ouvre une connexion GoogleLe type d'authentification n'est pas défini sur Gemini API keySélectionnez Use Gemini API key, ou définissez security.auth.selectedType
"Invalid auth method selected"GOOGLE_API_KEY est utilisée avec une URL de base personnaliséeUtilisez GEMINI_API_KEY et supprimez GOOGLE_API_KEY avec unset
Les requêtes vont à Google, pas à la passerelleGOOGLE_GEMINI_BASE_URL n'est pas définie dans ce shellExportez la variable, puis relancez gemini
404 lors des appels de modèlesL'URL de base contient /v1betaUtilisez uniquement l'origine http://localhost:3001
Les appels d'outils échouentLa famille Gemini correspond à un modèle qui gère mal l'appel d'outilsAssociez la famille à un modèle des tableaux ci-dessus
"All models rate-limited after N attempts" (message affiché en anglais)Toutes les clés ont atteint leur limiteAjoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

Gemini CLI est-il toujours gratuit ?

Google a mis fin à l'usage gratuit de Gemini CLI avec une connexion Google pour les utilisateurs sans abonnement payant et les utilisateurs Google One, le 18 juin 2026. La CLI prend toujours en charge une URL de base personnalisée, elle peut donc fonctionner avec une passerelle gratuite comme FreeLLMAPI.

Comment utiliser Gemini CLI avec un point de terminaison personnalisé ?

Définissez GOOGLE_GEMINI_BASE_URL sur l'origine du point de terminaison et GEMINI_API_KEY sur sa clé, puis sélectionnez Use Gemini API key. Le point de terminaison doit parler l'API Gemini native sur /v1beta.

Gemini CLI peut-il utiliser des modèles qui ne sont pas Gemini ?

Oui, grâce à FreeLLMAPI. La passerelle associe les noms de familles Gemini Pro, Flash et Flash-Lite à Auto ou à n'importe quel modèle du catalogue, par exemple un modèle Qwen ou GLM.

Quelles sont les limites de l'offre gratuite de l'API Gemini ?

Google fixe les limites par projet, et non par clé, et affiche les valeurs actuelles dans Google AI Studio. Le tableau de cette page présente les modèles Gemini gratuits actuels et leurs limites, d'après le catalogue FreeLLMAPI.

Pourquoi obtenir « Invalid auth method selected » ?

Un ticket de Gemini CLI signale cette erreur dans la version 0.44.x lorsque GOOGLE_API_KEY est utilisée avec GOOGLE_GEMINI_BASE_URL. Utilisez GEMINI_API_KEY et supprimez GOOGLE_API_KEY avec unset.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits