Skip to main content

Introduction

Gemini CLI est l’outil officiel en ligne de commande de Google qui permet aux développeurs d’interagir avec les modèles d’IA Gemini depuis le terminal. Après avoir configuré l’API APIMart, vous pouvez utiliser les modèles avancés d’APIMart — GPT, Claude et Gemini — dans Gemini CLI.

Prérequis

Avant de commencer :
  1. Node.js et npm installés
    Téléchargez et installez depuis le site Node.js (v16 ou plus récent recommandé)
  2. Clé API APIMart
    Connectez-vous à la console APIMart et copiez votre clé API (commence par sk-)
Astuce : si vous n’avez pas encore de compte APIMart, inscrivez-vous d’abord sur APIMart et créez une clé API.

Étape 1 : Installer Gemini CLI

1.1 Installation globale

Installez Gemini CLI globalement avec npm :

1.2 Vérifier l’installation

Vérifiez que la CLI est disponible :
Si un numéro de version s’affiche, l’installation a réussi.
Astuce : si la commande n’est pas trouvée, redémarrez votre terminal ou vérifiez votre configuration PATH globale npm.

Étape 2 : Configurer l’API APIMart

2.1 Variables d’environnement temporaires

Pour des tests ou une utilisation ponctuelle ; les valeurs sont effacées à la fermeture du terminal. Windows (PowerShell) :
macOS/Linux (Bash) :

2.2 Variables d’environnement permanentes (recommandé)

Conserver la configuration pour que les nouveaux shells la reprennent automatiquement. Windows (PowerShell) :
  1. Exécuter PowerShell en tant qu’administrateur
  2. Définir les variables d’environnement utilisateur :
  1. Redémarrez PowerShell ou rechargez les variables :
macOS/Linux (Bash) :
  1. Modifiez le fichier rc de votre shell :
  1. Ajoutez :
  1. Rechargez :

2.3 Utiliser un fichier .env

Créez .env dans votre projet :
Chargez les variables avant d’exécuter Gemini : macOS/Linux :
Windows (PowerShell) :
Important : - Remplacez sk-xxxxxxxxxxxx par votre vraie clé depuis la console APIMart - Définissez GEMINI_BASE_URL à https://api.apimart.ai/v1 pour que Gemini CLI dialogue avec APIMart - Ajoutez .env à .gitignore pour ne pas committer les clés

2.4 Vérifier la configuration

macOS/Linux :
Windows (PowerShell) :
Si les valeurs semblent correctes, la configuration a réussi.

Étape 3 : Utiliser Gemini CLI

3.1 Chat de base

Session interactive :
Prompt ponctuel :

3.2 Choisir un modèle

Ou :

3.3 Lire les prompts depuis un fichier

Ou par pipe :

3.4 Sauvegarder la sortie dans un fichier

Étape 4 : Appeler APIMart depuis votre code

4.1 SDK Python

4.2 JavaScript / TypeScript

4.3 cURL

Étape 5 : Choisir un modèle

Modèles recommandés

APIMart prend en charge de nombreux modèles ; choisissez selon la tâche et le budget. Gemini GPT Claude
Choix rapides : - 🚀 Stack style Google : gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Codage : claude-sonnet-4-5-20250929, gpt-5 - 💰 Coût : gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Vitesse : gemini-2.0-flash-exp, gpt-4o-mini

Fonctionnalités avancées

Multimodal (images)

Avec un modèle multimodal tel que Gemini 2.0 Flash :

Streaming

Diffuser les tokens à mesure qu’ils arrivent :

Ajustement des paramètres

Forme du caractère aléatoire et de la longueur :

FAQ

Q1 : « Invalid API key » ou erreurs d’authentification

  1. Format de la clé
    • Doit commencer par sk-
    • Pas d’espaces supplémentaires lors du collage
  2. Variables d’environnement
  3. Statut de la clé
    • Vérifiez la clé dans la console APIMart
    • Assurez-vous que votre compte a du solde

Q2 : Comment vérifier la configuration de l’API ?

Q3 : Quels langages sont pris en charge ?

Tout langage capable d’envoyer des requêtes HTTP fonctionne avec APIMart :
  • Python — SDK OpenAI recommandé
  • JavaScript / TypeScript — Node ou navigateur
  • Java — client HTTP
  • Go — stdlib ou bibliothèques
  • PHP — cURL ou Guzzle
  • Ruby — gems HTTP
  • C# / .NETHttpClient
  • SwiftURLSession
  • Autres — tout ce qui supporte HTTP

Q4 : Où voir l’utilisation et la facturation ?

Dans la console APIMart :
  • 📊 Statistiques d’appels en direct
  • 💰 Coûts et factures
  • 📈 Tendances d’utilisation
  • 🔍 Journaux des requêtes
  • ⚙️ Gestion des clés API

Q5 : Erreurs API courantes

Bonnes pratiques

1. Nouvelles tentatives et backoff

2. Contrôle des coûts

3. Prompts système

Fonctionnalités

Avec Google AI Studio et APIMart, vous obtenez :
  • 🤖 De nombreux modèles — GPT, Claude, Gemini et plus
  • 🌍 Compatible OpenAI — forme de requête/réponse familière
  • Performances — faible latence, forte concurrence
  • 💰 Tarification claire — paiement à l’usage
  • 📊 Observabilité — surveillez les appels en temps réel
  • 🔒 Sécurité — garanties orientées entreprise
  • 🚀 Intégration rapide — appels HTTP/SDK simples
  • 📚 Documentation — guides et exemples

Support


Commencer avec APIMart

Créez un compte, obtenez une clé API et utilisez plusieurs modèles d’IA depuis les workflows Google AI Studio et au-delà.