Configuration Gemini

Créez une clé dans le tableau de bord et sélectionnez le canal Gemini. Le canal modifie la vitesse de consommation (0.625×), sans modifier le quota acheté.

Ce canal accepte les fonctions que vous déclarez et exécutez dans votre client. Les outils hébergés comme Google Search et Google Maps renvoient HTTP 400 avant transmission. Le proxy transmet le contenu valide dès sa réception et facture la consommation communiquée par le fournisseur. Les références explicites à cachedContent peuvent contenir des outils et sont également refusées. Le cache implicite reste disponible.

La génération utilise le niveau de service standard. Un niveau sans tarif ou un fichier distant référencé par fileData entraîne une réponse HTTP 400. Si le corps précise un modèle, son nom doit correspondre à celui de l’URL. Avec la même clé, countTokens compte les tokens du texte et des médias intégrés sans consommer le quota de génération.

Utilisez GET /v1beta/models pour afficher les modèles disponibles.

Une requête de génération est admise tant que la clé API et la source de financement ont chacune un solde positif. Les limites de sortie et d’outils demandées sont conservées. La facturation repose sur l’usage réel et des requêtes simultanées peuvent rendre le solde négatif.

Modèles pris en charge

gemini-4-carbon est disponible. gemini-3.5-flash reste le modèle par défaut ; gemini-3.7-flash et gemini-3.8-flash restent également disponibles. Les clés AWSQ, CCMAX et Codex ne peuvent pas appeler ces modèles. Les prix sont indiqués en USD par million de tokens. Si votre travail demande plutôt des modèles GPT, utilisez une clé Codex ; GPT-6.1 Sol ou Terra compare ces deux modèles GPT-6.1.

Carbon suit les tarifs de lancement officiels. Google indique une date sans fuseau horaire ; ce service change les tarifs à 00:00 UTC le 01/12/2026. La sortie inclut les tokens de réflexion.

gemini-4-carbon est aussi disponible sur le canal Gemini. Consultez le tableau des prix en vigueur et sélectionnez Gemini pour les tarifs d’entrée, de lecture du cache et de sortie. Carbon utilise 50 % des tarifs de base habituels configurés avant le 01/12/2026 à 00:00 UTC, puis les tarifs complets. Le tableau inclut cette offre et le coefficient du canal.

Gemini CLI

Le guide officiel de Gemini CLI demande Node.js 20.0.0 ou une version plus récente. Vérifiez votre version :

1
node --version

Si Node.js est absent ou antérieur à 20.0.0, installez une version prise en charge. La configuration ci-dessous a été vérifiée avec Gemini CLI 0.67.0 ; installez cette version pour reproduire ces étapes :

1
npm install -g @google/[email protected]
2
gemini --version

Configurer le projet

Dans le dossier du projet, créez .gemini/settings.json. Si ce fichier existe déjà, fusionnez les champs et ajoutez les entrées customOverrides au tableau existant. Transmettez la clé API par une variable d’environnement, sans la placer dans ce fichier.

1
{
2
  "security": { "auth": { "selectedType": "gemini-api-key" } },
3
  "model": { "name": "gemini-3.8-flash" },
4
  "modelConfigs": {
5
    "customOverrides": [
6
      {"match": {"model": "base"}, "modelConfig": {"model": "gemini-3.8-flash"}},
7
      {"match": {"model": "gemini-3-pro-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},
8
      {"match": {"model": "gemini-3-flash-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},
9
      {"match": {"model": "gemini-3.1-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}},
10
      {"match": {"model": "gemini-2.5-pro"}, "modelConfig": {"model": "gemini-3.8-flash"}},
11
      {"match": {"model": "gemini-2.5-flash"}, "modelConfig": {"model": "gemini-3.8-flash"}},
12
      {"match": {"model": "gemini-2.5-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}}
13
    ]
14
  },
15
  "agents": {
16
    "overrides": {
17
      "codebase_investigator": { "modelConfig": { "model": "gemini-3.8-flash" } }
18
    }
19
  },
20
  "tools": { "exclude": ["google_web_search", "web_fetch"] }
21
}

Cette configuration utilise une clé API et sélectionne gemini-3.8-flash pour la conversation principale, les requêtes auxiliaires intégrées, la compression du contexte et le sous-agent d’analyse du dépôt. --model ne remplace pas tous les modèles auxiliaires ou de sous-agents. Les outils hébergés Google Search et de contexte URL sont exclus, car ce canal ne les prend pas en charge. Les outils locaux de fichiers et de shell restent disponibles.

Démarrer depuis le dossier du projet

Remplacez la valeur fictive par votre clé Gemini du tableau de bord. Au premier lancement, confirmez la confiance dans le projet lorsque le CLI le demande afin de charger ses paramètres :

1
export GEMINI_API_KEY="VOTRE_CLÉ_DU_TABLEAU_DE_BORD"
2
export GOOGLE_GEMINI_BASE_URL='https://api.aiinide.com'
3
gemini --model gemini-3.8-flash

Conservez le modèle explicite : sans les paramètres du projet, gemini utilise le routage Auto du client et non le modèle par défaut du catalogue de ce service. Après une mise à jour du CLI, un changement de modèle ou l’ajout d’agents ou d’extensions personnalisés, vérifiez aussi leurs modèles. Si Model "…" is not configured apparaît, vérifiez le modèle indiqué et les paramètres chargés. Consultez les guides officiels de configuration des modèles et des sous-agents.

Utilisez uniquement la clé du tableau de bord dans le client, jamais la clé upstream GEMINI_API_KEY du serveur.

Requête standard

Cet exemple contient tout le code à expliquer et ne lit aucun fichier local. Remplacez la valeur fictive par votre clé Gemini du tableau de bord et utilisez un shell compatible avec Bash. Les deux exemples ci-dessous consomment du quota selon leur utilisation réelle.

1
export GEMINI_API_KEY="VOTRE_CLÉ_DU_TABLEAU_DE_BORD"
2
 
3
curl --globoff --fail-with-body 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:generateContent' \
4
  -H "x-goog-api-key: $GEMINI_API_KEY" \
5
  -H "Content-Type: application/json" \
6
  -d '{"contents":[{"role":"user","parts":[{"text":"Explique en une phrase la valeur renvoyée par cette fonction JavaScript : function add(a, b) { return a + b; }"}]}]}'

Vérifiez la présence du texte dans candidates[].content.parts[].text et de finishReason: "STOP" pour ce candidat. Exemple : « Elle additionne deux nombres, ou les concatène si une valeur est une chaîne. » La formulation peut varier. Sans réponse, examinez promptFeedback et finishReason ; MAX_TOKENS indique que la limite de sortie a été atteinte. Consultez votre historique de consommation pour vérifier la consommation réelle.

Réponse en flux

Réutilisez la clé définie ci-dessus. Remplacez generateContent par streamGenerateContent, ajoutez ?alt=sse et utilisez curl -N pour afficher les fragments dès leur arrivée :

1
curl --globoff --fail-with-body -N 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse' \
2
  -H "x-goog-api-key: $GEMINI_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"contents":[{"role":"user","parts":[{"text":"Explique en une phrase la valeur renvoyée par cette fonction JavaScript : function add(a, b) { return a + b; }"}]}]}'

La réponse contient des événements SSE data:. Lisez dans l’ordre les fragments de réponse de candidates[].content.parts[].text et vérifiez que le candidat se termine par finishReason: "STOP". Le texte doit expliquer la même fonction. Un statut HTTP 200 ou un premier fragment ne suffit pas à confirmer la fin de la réponse ; une déconnexion ou une autre raison de fin demande vérification.

Le client Gemini ajoute /v1beta/models/... à l’URL de base. Les anciennes URL de base se terminant par /api/codex ou /api/gemini restent utilisables avec les mêmes clés.

401 indique une clé invalide, 400 un canal ou modèle incorrect, 429 une limite atteinte et 503 une indisponibilité temporaire de l’amont.