Gemini CLI

Utiliser Gemini CLI avec une clé de passerelle et l’API native v1beta.

Installation et préparation

  1. Installez Node.js 20 ou ultérieur, puis le paquet npm officiel Gemini CLI ci-dessous. Vérifiez gemini --version.
  2. Créez une clé dans routerra.ai Clés API pour un modèle Gemini natif des modèles. La connexion utilise Gemini generateContent/streamGenerateContent, pas OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Configurer le routage Gemini natif

  1. Définissez les trois variables dans le terminal de lancement. Le SDK ajoute /v1beta/models/... ; GOOGLE_GEMINI_BASE_URL doit donc être https://routerra.ai, sans /v1 ni /v1beta. Remplacez clé et modèle.
  2. Choisissez Use Gemini API key ; les versions récentes peuvent détecter l’authentification de passerelle. Une session Google ou Vertex existante peut contourner cette route : changez-la avec /auth. Pour conserver les variables, écrivez des lignes NAME=value dans ~/.gemini/.env, puis redémarrez. Ne versionnez pas ce fichier.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Pour Windows PowerShell :

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Vérifier la connexion

Testez une invite courte avec --model explicite. Une page de connexion Google indique le mauvais mode. /v1/v1beta ou /v1beta/v1beta révèle un chemin en trop dans l’URL. Si le modèle est refusé, vérifiez sa compatibilité Gemini native plutôt que d’utiliser un ID OpenAI. Supprimez les valeurs conflictuelles GOOGLE_GENAI_USE_VERTEXAI ou GOOGLE_GENAI_USE_GCA, redémarrez et vérifiez l’usage routerra.ai.