models.json から互換性のある外部 API に接続できます。BetterToken を例に、API Key、プロトコルに合う Base URL、Model ID を設定します。他のサービスでは、そのサービスの URL、認証情報、モデル ID を使ってください。
主要設定
前提条件
- Node.js 22.19 以降。
- BetterToken API Key を作成し、model plaza でツール呼び出しに対応するモデルを選びます。
- ネイティブ Windows では Pi の Bash ツール用に Git for Windows をインストールするか、WSL 内で Pi を実行します。
インストール
現在の公式 npm コマンドを実行します。手動設定
API Key を設定する
Pi を起動するターミナルで、YOUR_API_KEY を自分の Key に置き換えます。
- macOS / Linux
- Windows PowerShell
モデルを取得して設定を生成する
モデル一覧を取得をクリックすると、API Key を入力せずに BetterToken の最新の公開モデルカタログを取得できます。API とツール呼び出しに対応したモデルを選び、Model ID をコピーするか、生成されたmodels.json をダウンロードしてください。
すでに models.json がある場合は、ファイル全体を置き換えず、生成された bettertoken エントリを既存の設定に統合してください。設定は上で指定した $BETTERTOKEN_API_KEY 変数を使用します。必要な追加パラメータはモデルの実際の機能に合わせて設定してください。
Pi は複数のプロトコルに対応しています。モデルとサーバーが対応するものを選んでください。この接続では、Claude には Anthropic Messages、GPT にはサーバーが対応している場合に Responses、その他の OpenAI 互換モデルには Chat Completions をおすすめします。選択欄の初期値は Chat Completions で、公開カタログに記載された API に基づいて一覧を絞り込みます。Responses に目的のモデルが表示されない場合は、Responses 対応を確認したモデルについて以下の手動設定例を使ってください。
URL とモデルを追加する
~/.pi/agent/models.json を作成します。Windows の標準パスは %USERPROFILE%\.pi\agent\models.json です。既存のファイルがある場合は、providers オブジェクトに bettertoken の項目を追加します。
生成した設定を使わない場合は、以下の Responses API の例を手動で設定できます。YOUR_MODEL_ID を model plaza の ID に置き換え、環境変数を参照する $BETTERTOKEN_API_KEY はそのまま残します。
baseUrl と api を対応する組み合わせに変更します。
モデルのツール呼び出しに対応する API を選びます。たとえば GPT-6.1 Sol では Responses を使います。Base URL は表の値を指定し、具体的なリクエストパスは Pi に任せます。
Pi を起動する
プロジェクトディレクトリで、設定した Model ID を使って実行します。接続の確認
pi --list-models を実行し、bettertoken とモデルが表示されることを確認します。続いて Pi を起動し、次を送信します。
PI_OK が返ったら、小さな読み取り専用タスクでツール呼び出しも確認します。
モデルの切り替え
models 配列にモデルを追加し、Pi で /model を実行すると models.json が再読み込みされます。モデルを選び、Ctrl+S で新しいセッションのデフォルトに設定できます。異なるプロトコルには別のローカル名を使い、それぞれに api と baseUrl を指定します。
よくあるエラー
高度な設定
画像、推論レベル、長いコンテキストが必要な場合は、モデルの実際の能力に合わせてinput、reasoning、contextWindow、maxTokens を設定します。モデル選択ガイドも参照してください。
技術情報
providers と --provider は Pi のクライアント設定項目です。bettertoken はこの例のローカル名です。Pi は最初に --api-key、次に auth.json の保存済み認証情報、その後に models.json の apiKey を使います。同じ名前に古い認証情報がある場合は、Pi の /logout で該当項目を削除して再接続します。