pi コーディング エージェント API のセットアップ

pi の公式 Custom Models メカニズムは、~/.pi/agent/models.json からゲートウェイとカスタム モデルをロードします。 TokenHub は、openai-completions API タイプを使用します。ここには一般的な「プロバイダーの追加」フォームはありません。この構成ファイルはサポートされているエントリ ポイントです。

ステップ 1: models.json の認証情報を準備する

pi を起動するのと同じ端末で、次のように設定します。

export TOKENHUB_API_KEY="sk-..."

models.json で環境変数を読み取るには、値が "$TOKENHUB_API_KEY" である必要があります。 pi のドキュメントには、``models.jsonで環境変数を読み取るには、値が"$TOKENHUB_API_KEY"` である必要があります。 pi のドキュメントには、 のない大文字の文字列は環境変数名ではなくリテラル キーとして扱われると記載されています。

ステップ 2: ~/.pi/agent/models.json を編集する

{
  "providers": {
    "tokenhub": {
      "baseUrl": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": [
        {
          "id": "YOUR_TOKENHUB_MODEL_ID",
          "name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

TokenHub モデル ページの各フィールドを修正します。

• id は、API に送信されるモデル ID であり、必須です。
• 拡張推論をサポートするモデルの場合のみ、reasoning を true に設定します。
• input のデフォルトはテキストです。 ["text", "image"]は画像入力モデルのみご使用ください。
• contextWindow にはデフォルトがありますが、モデルの実際のコンテキスト ウィンドウを宣言します。
• maxTokens は最大出力であり、コンテキスト ウィンドウではありません。

TokenHub はベアラー トークンを使用します。 pi バージョンで Authorization ヘッダーが自動的に追加されない場合は、プロバイダー レベルで "authHeader": true を追加します。

ステップ 3: /model を開いてファイルをリロードします

pi セッション内で /model を実行します。 pi は、/model が開くたびに models.json をリロードするため、再起動は必要ありません。 tokenhub/YOUR_TOKENHUB_MODEL_ID を選択し、1 つのファイルを説明するように依頼し、それが成功した場合にのみツールの呼び出しをテストします。

プロバイダーとモデルが表示されても選択できない場合は、ファイルはロードされましたが、資格情報が解決されませんでした。環境変数を確認するか、/login / auth.json でプロバイダー キーを保存してください。

必要な場合にのみ pi 固有の互換性オーバーライドを適用する

一部の OpenAI-compatible サービスは、developer ロールまたは reasoning_effort を拒否します。これらのフラグは、対応する 400 エラーが発生した後にのみ追加してください。

"compat": {
  "supportsDeveloperRole": false,
  "supportsReasoningEffort": false
}

先制的に機能を無効にしないでください。基本的なリクエストが成功したら、thinkingLevelMap、画像入力、サンプリング パラメーター、または正確なモデルのみの価格設定を構成します。

pi のロード動作に応じたトラブルシューティング

• プロバイダーが /model にまったくありません: ファイル パス、JSON 構文、baseUrl、および api を確認してください。
• プロバイダーは存在しますが、モデルを選択できません: $TOKENHUB_API_KEY が解決されなかったか、プロバイダーに保存された資格情報がありません。
• 401: pi プロセスが変数を継承したことを確認し、必要に応じて authHeader: true を設定します。
• 400 または早期の切り捨て: 正しい contextWindow、maxTokens、または compat。単に数字を増やすだけではありません。
• 変更は表示されません。現在のセッションに表示されている古い選択に依存する代わりに、/model を再度開きます。

公式リファレンス

• pi: カスタム モデル
• pi: カスタム プロバイダー拡張機能 API