Home
Vibe

Clés API et profils

Vibe Code CLI nécessite une clé API Mistral pour appeler les modèles hébergés. Cette page décrit comment créer une clé, l’ajouter au CLI et changer de clé selon les comptes ou fournisseurs.

i
Information

La connexion via navigateur est activée par défaut lorsque votre configuration cible un modèle avec un fournisseur Mistral. Ce flux gère automatiquement la création et le stockage des identifiants ; aucune clé API n’est nécessaire pour les configurations Mistral typiques. Cette page reste pertinente pour les fournisseurs non-Mistral, l’automatisation, le dépannage ou si vous souhaitez utiliser une clé API personnalisée.

Où créer votre clé API

Où créer votre clé API

Créez votre clé depuis Code › Vibe CLI. La même clé fonctionne en mode gratuit, avec un plan payant ou avec le paiement à l'usage activé.

Astuce

Sécurisez vos clés :

  • Utilisez la clé la moins privilégiée possible pour la tâche.
  • Faites tourner régulièrement les clés et révoquez celles non utilisées dans la console.
  • Ne collez jamais de clés API dans un prompt, des journaux, captures d’écran ou tickets de support.
Fournir la clé API au CLI

Fournir la clé API au CLI

La CLI prend en charge trois méthodes pour fournir votre clé. Lorsque plusieurs clés sont définies, la CLI utilise la première clé qu'elle trouve, dans cet ordre : votre environnement shell, puis ~/.vibe/.env, puis le trousseau de votre système d'exploitation (par exemple, le trousseau macOS ou le Gestionnaire d'identifiants Windows), où l'assistant enregistre les clés.

1. Configuration interactive (recommandée)

1. Configuration interactive (recommandée)

Lors du premier lancement, le CLI lance un assistant de configuration s’il ne trouve pas de clé :

vibe

Vous pouvez aussi relancer la configuration à tout moment :

vibe --setup

L'assistant enregistre la clé dans le trousseau de votre système d'exploitation pour les prochaines sessions. Si aucun trousseau n'est disponible, l'assistant enregistre la clé dans ~/.vibe/.env, lisible uniquement par vous.

2. Variable d’environnement

2. Variable d’environnement

Exportez la clé dans votre shell :

export MISTRAL_API_KEY="your_mistral_api_key"

Les variables d'environnement ont la priorité sur les valeurs enregistrées dans ~/.vibe/.env et dans le trousseau.

3. Fichier .env

3. Fichier .env

Vous pouvez également modifier directement ~/.vibe/.env :

MISTRAL_API_KEY=your_mistral_api_key

Le CLI charge automatiquement ~/.vibe/.env au démarrage.

Note

Le fichier .env est réservé aux identifiants. Pour la configuration générale du CLI, utilisez config.toml. Voir Configuration.

Vérifier les identifiants utilisés par Vibe

Vérifier les identifiants utilisés par Vibe

Exécutez /status dans une session pour voir le modèle et le fournisseur actifs, la source d'identifiants utilisée et les sources qu'elle remplace. Exécutez /whoami pour voir votre compte connecté, votre espace de travail, votre plan et la portée de votre clé API.

Changer de compte ou de fournisseur

Changer de compte ou de fournisseur

Le CLI gère plusieurs fournisseurs et modèles via des presets dans config.toml. Utilisez-les pour, par exemple, basculer entre une clé Mistral pour la production et une clé d’un autre fournisseur compatible OpenAI pour les tests.

Définissez un preset de fournisseur et un preset de modèle :

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
input_price = 0.0
output_price = 0.0

Définissez le modèle actif :

active_model = "devstral-openrouter"

Puis exportez la clé API correspondante :

export OPENROUTER_API_KEY="your_openrouter_api_key"

Vous pouvez aussi modifier le modèle actif à tout moment dans le CLI avec /config ou /model.

Informations sur les plans et la facturation

Informations sur les plans et la facturation

Les plans Mistral incluent une utilisation mensuelle partagée entre Studio, l'API et Vibe Code. Vibe Code utilise cette utilisation mensuelle incluse avant toute facturation à l'usage.

Une fois l'utilisation mensuelle incluse épuisée, la suite dépend des paramètres de votre Organisation :

  • Paiement à l'usage désactivé : Vibe Code peut s'arrêter jusqu'à la prochaine période de facturation.
  • Paiement à l'usage activé : Vibe Code continue de fonctionner, et toute utilisation supplémentaire est déduite de vos crédits prépayés. Lorsque votre solde atteint zéro, Vibe Code s'arrête jusqu'à ce que vous ajoutiez des crédits.

Le paiement à l'usage est désactivé par défaut. Certains plans Pro souscrits via des partenaires (Google, Apple, Free Mobile, Orange) ne peuvent pas activer le paiement à l'usage. Sur ces plans, Vibe Code s'arrête lorsque l'utilisation mensuelle incluse est épuisée.