models.json. Cet exemple utilise BetterToken : définissez la clé, la Base URL du protocole et le Model ID. Pour un autre service, utilisez son URL, ses identifiants et ses modèles.
Paramètres principaux
Prérequis
- Node.js 22.19 ou une version ultérieure.
- Créez une BetterToken API Key et choisissez un modèle prenant en charge les appels d’outils dans la model plaza.
- Sous Windows natif, installez Git for Windows pour l’outil Bash de Pi, ou lancez Pi dans WSL.
Installation
Utilisez la commande npm officielle actuelle de Pi :Configuration manuelle
Définir la clé API
Dans le terminal qui lancera Pi, remplacezYOUR_API_KEY par votre clé :
- macOS / Linux
- Windows PowerShell
Obtenir les modèles et générer la configuration
Cliquez sur Obtenir la liste des modèles pour consulter le catalogue public actuel de BetterToken sans saisir de clé API. Choisissez une API et des modèles compatibles avec les appels d’outils, puis copiez un Model ID ou téléchargez le fichiermodels.json généré.
Si models.json existe déjà, fusionnez l’entrée bettertoken générée avec votre configuration au lieu de remplacer le fichier. La configuration utilise la variable $BETTERTOKEN_API_KEY définie ci-dessus ; ajoutez les autres paramètres selon les capacités réelles du modèle.
Pi prend en charge plusieurs protocoles : choisissez celui que le modèle et le serveur acceptent. Pour cette connexion, nous recommandons Anthropic Messages pour Claude, Responses pour GPT si le serveur le permet, et Chat Completions pour les autres modèles compatibles OpenAI. Le sélecteur utilise Chat Completions par défaut et filtre les API déclarées dans le catalogue public. Si votre modèle ne figure pas sous Responses, utilisez l’exemple manuel ci-dessous pour les modèles dont la prise en charge de Responses est confirmée.
Ajouter l’URL et le modèle
Créez~/.pi/agent/models.json. Sous Windows, le chemin par défaut est %USERPROFILE%\.pi\agent\models.json. Si le fichier existe, ajoutez l’entrée bettertoken à son objet providers existant.
Vous pouvez aussi remplir manuellement cet exemple d’API Responses au lieu d’utiliser la configuration générée. Remplacez YOUR_MODEL_ID par un ID de la model plaza ; conservez $BETTERTOKEN_API_KEY comme référence à la variable :
baseUrl et api :
Choisissez une API permettant les appels d’outils pour votre modèle. Par exemple, GPT-6.1 Sol utilise Responses. Conservez la Base URL indiquée ; Pi ajoute le chemin de la requête.
Lancer Pi
Depuis le dossier du projet, utilisez le Model ID configuré :Vérifier la connexion
Lancezpi --list-models et vérifiez que bettertoken et votre modèle apparaissent. Démarrez ensuite Pi et envoyez :
PI_OK, essayez une petite tâche en lecture seule pour vérifier les appels d’outils.
Changer de modèle
Ajoutez des entrées au tableaumodels, puis lancez /model dans Pi pour relire models.json. Sélectionnez un modèle et appuyez sur Ctrl+S pour le définir par défaut pour les nouvelles sessions. Utilisez des noms locaux distincts pour des protocoles différents, chacun avec ses propres api et baseUrl.
Erreurs fréquentes
Configuration avancée
Pour les images, les niveaux de raisonnement ou un contexte plus long, définissezinput, reasoning, contextWindow et maxTokens selon les capacités réelles du modèle. Consultez le guide de sélection des modèles.
Détails techniques
providers et --provider sont des champs de configuration de Pi ; bettertoken est le nom local de cet exemple. Pi utilise d’abord --api-key, puis les identifiants enregistrés dans auth.json, puis apiKey dans models.json. Si ce nom possède d’anciens identifiants, supprimez l’entrée correspondante via /logout dans Pi avant de vous reconnecter.