Gemini CLI

Gemini CLI est l'agent open source de Google pour le terminal. Deux variables d'environnement suffisent pour le diriger vers Synthorai : il appelle alors l'endpoint natif Gemini de la passerelle avec votre clé Synthorai.

Avant de commencer

Créez une clé API sur la page Clés API de la console. Copiez-la tout de suite : elle n'est affichée qu'une fois.

Étape 1 - Définir les variables d'environnement

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

Quand Gemini CLI demande comment s'authentifier, choisissez Use Gemini API key. La clé est envoyée dans l'en-tête x-goog-api-key, que la passerelle accepte sur son endpoint natif Gemini : /v1beta/models/{model}:generateContent et :streamGenerateContent.

Étape 2 - Choisir un modèle

Passez à -m un modèle Gemini que votre clé peut appeler. La page des modèles les liste.

Seuls generateContent et streamGenerateContent sont servis sur ce chemin. Les autres méthodes, comme countTokens et embedContent, répondent 404 et ne sont pas facturées.

Garder les réglages dans un fichier

Plutôt que d'exporter les variables dans chaque shell, vous pouvez les placer dans ~/.gemini/.env :

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

Dépannage

401 La clé est erronée, ou elle n'est pas définie dans le shell qui lance gemini.

404 sur un modèle Ce modèle n'est pas activé pour votre clé. Choisissez-en un que votre clé peut appeler.

/v1/v1beta dans une URL Retirez /v1 de GOOGLE_GEMINI_BASE_URL.

Pour comparer le prix des modèles Gemini, consultez le comparatif des prix des modèles.