orientxorientx

Pi

使用 Messages API 的 Earendil 程式設計代理

Pi 是終端機程式設計代理。進行工具呼叫時應使用 Anthropic Messages(api: "anthropic-messages"),而非 Chat Completions; 否則工具結果會以 role: "tool" 回傳,API 將回應 400。

Base URLhttps://api.orientx.ai
身分驗證ORIENTX_API_KEY,並設定 authHeader: true
設定檔~/.pi/agent/models.json
官方文件自訂模型

安裝

curl -fsSL https://pi.dev/install.sh | bash

需要 Node.js ≥ 22.19。執行 pi --version 確認安裝成功。

新增提供者

{
  "providers": {
    "orientx": {
      "name": "orientx",
      "baseUrl": "https://api.orientx.ai",
      "apiKey": "$ORIENTX_API_KEY",
      "authHeader": true,
      "api": "anthropic-messages",
      "models": [
        {
          "id": "<MODEL_ID>",
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

baseUrl 應為主機根位址,Pi 會自行加上 /v1/messages。 如果手動新增 /v1,請求路徑會變成 POST /v1/v1/messages,並回傳 404。 authHeader: true 會傳送 Authorization: Bearer;未啟用時 Pi 僅設定 x-api-key, 某些環境下會回傳 401。

如果使用了 "$ORIENTX_API_KEY",請匯出金鑰:

export ORIENTX_API_KEY="sk-..."

執行 Pi

pi

輸入 /model 並選擇 orientx 的模型 ID。

使用代理時,不要將 api 設定為 openai-completions。 Chat Completions 會拒絕 Pi 的工具輪次,並回傳 Unexpected role "tool"。

本頁目錄