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-cliOuvrez 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>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiLorsque 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"
}
}
}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éfinissezGEMINI_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èle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.8 Live | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
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.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
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ème | Cause | Solution |
|---|---|---|
| Gemini CLI ouvre une connexion Google | Le type d'authentification n'est pas défini sur Gemini API key | Sé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ée | Utilisez GEMINI_API_KEY et supprimez GOOGLE_API_KEY avec unset |
| Les requêtes vont à Google, pas à la passerelle | GOOGLE_GEMINI_BASE_URL n'est pas définie dans ce shell | Exportez la variable, puis relancez gemini |
404 lors des appels de modèles | L'URL de base contient /v1beta | Utilisez uniquement l'origine http://localhost:3001 |
| Les appels d'outils échouent | La famille Gemini correspond à un modèle qui gère mal l'appel d'outils | Associez 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 limite | Ajoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente |
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
- free gemini api
- Quota de l'API Gemini dépassé (429 RESOURCE_EXHAUSTED)
- Utiliser Claude Code gratuitement
- Utiliser Codex CLI avec des modèles gratuits
- Meilleures API gratuites de modèles de code
Sources
- Gemini CLI docs: configuration reference (vérifié le 20 November 2026)
- Gemini CLI docs: authentication (vérifié le 20 November 2026)
- Gemini CLI docs: quota and pricing (vérifié le 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (vérifié le 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (vérifié le 20 November 2026)
- Google AI Studio: rate limits (vérifié le 20 November 2026)
- FreeLLMAPI docs: native Gemini API (vérifié le 20 November 2026)