models.json mit kompatiblen Drittanbieter-APIs. Das Beispiel nutzt BetterToken: Lege den Schlüssel, die Base URL des Protokolls und die Model ID fest. Für einen anderen Dienst verwende dessen URL, Zugangsdaten und Modell-IDs.
Wichtige Einstellungen
Voraussetzungen
- Node.js 22.19 oder neuer.
- Erstelle einen BetterToken API Key und wähle in der model plaza ein Modell mit Tool-Aufrufen.
- Installiere unter nativem Windows Git for Windows für Pis Bash-Tool oder führe Pi in WSL aus.
Installation
Nutze Pis aktuellen offiziellen npm-Befehl:Manuelle Konfiguration
API Key setzen
Ersetze im Terminal, aus dem du Pi startest,YOUR_API_KEY durch deinen Schlüssel:
- macOS / Linux
- Windows PowerShell
Modelle abrufen und Konfiguration erstellen
Klicke auf Modellliste abrufen, um den aktuellen öffentlichen BetterToken-Katalog ohne Eingabe eines API Key zu laden. Wähle eine API und Modelle mit Tool-Aufrufen. Kopiere dann eine Model ID oder lade die erzeugtemodels.json herunter.
Wenn models.json bereits existiert, füge den erzeugten Eintrag bettertoken in deine Konfiguration ein, statt die Datei zu ersetzen. Die Konfiguration verwendet die oben gesetzte Variable $BETTERTOKEN_API_KEY. Ergänze weitere Parameter anhand der tatsächlichen Modellfähigkeiten.
Pi unterstützt mehrere Protokolle. Wähle eines, das Modell und Server unterstützen. Für diese Verbindung empfehlen wir Anthropic Messages für Claude, Responses für GPT, sofern der Server es unterstützt, und Chat Completions für andere OpenAI-kompatible Modelle. Die Auswahl startet mit Chat Completions und filtert nach den im öffentlichen Katalog angegebenen APIs. Fehlt dein Modell unter Responses, nutze das manuelle Beispiel unten für Modelle mit bestätigter Responses-Unterstützung.
URL und Modell hinzufügen
Erstelle~/.pi/agent/models.json. Unter Windows lautet der Standardpfad %USERPROFILE%\.pi\agent\models.json. Falls die Datei existiert, ergänze den Eintrag bettertoken im vorhandenen Objekt providers.
Alternativ zur erzeugten Konfiguration kannst du dieses Responses-API-Beispiel manuell ausfüllen. Ersetze YOUR_MODEL_ID durch eine ID aus der model plaza und behalte $BETTERTOKEN_API_KEY als Variablenreferenz bei:
baseUrl als auch api passend:
Wähle eine API mit Tool-Aufrufen für dein Modell. GPT-6.1 Sol nutzt beispielsweise Responses. Behalte die angegebene Base URL bei; Pi ergänzt den Anfragepfad.
Pi starten
Führe im Projektverzeichnis den Befehl mit deiner konfigurierten Model ID aus:Verbindung prüfen
Führepi --list-models aus und prüfe, ob bettertoken und dein Modell erscheinen. Starte danach Pi und sende:
PI_OK eine kleine schreibgeschützte Aufgabe, um Tool-Aufrufe zu prüfen.
Modell wechseln
Ergänze Modelle im Arraymodels und öffne /model in Pi, um models.json neu einzulesen. Wähle ein Modell und drücke Ctrl+S, um es für neue Sitzungen als Standard zu speichern. Nutze für verschiedene Protokolle getrennte lokale Namen mit eigenen Werten für api und baseUrl.
Häufige Fehler
Erweiterte Konfiguration
Setze für Bilder, Reasoning-Stufen oder größeren Kontextinput, reasoning, contextWindow und maxTokens nach den tatsächlichen Modellfähigkeiten. Siehe den Leitfaden zur Modellwahl.
Technische Details
providers und --provider sind Konfigurationsfelder des Pi-Clients; bettertoken ist der lokale Name in diesem Beispiel. Pi prüft zuerst --api-key, dann gespeicherte Zugangsdaten aus auth.json und danach apiKey in models.json. Sind für diesen Namen alte Zugangsdaten gespeichert, entferne den entsprechenden Eintrag mit /logout in Pi und verbinde dich erneut.