models.json 接入兼容的第三方 API。下面以 BetterToken 为例：设置 API Key，填写与协议匹配的 Base URL，并指定模型 ID。接入其他服务时，替换为该服务提供的 URL、凭据和模型 ID。
重点信息
准备工作
- Node.js 22.19 或更新版本。
- 创建 BetterToken API Key，并从模型广场选择支持工具调用的模型。
- 原生 Windows 用户安装 Git for Windows，供 Pi 的 Bash 工具使用；也可以在 WSL 内运行。
安装
按照 Pi 当前官方 npm 安装方式执行：手动配置
设置 API Key
在启动 Pi 的终端里设置变量，将YOUR_API_KEY 替换为你的 Key：
- macOS / Linux
- Windows PowerShell
获取模型并生成配置
点击 获取模型列表，即可获取 BetterToken 当前的公开模型目录，无须输入 API Key。选择接口和支持工具调用的模型，再复制 Model ID 或下载生成的models.json。
如果已有 models.json，将生成的 bettertoken 条目合并到现有配置，不要直接覆盖文件。配置使用上方设置的 $BETTERTOKEN_API_KEY 环境变量；需要其他模型参数时，再按实际能力补充。
Pi 支持多种协议，应按模型和服务端支持情况选择。本页建议：Claude 优先使用 Anthropic Messages；GPT 在服务端支持时优先使用 Responses；其他 OpenAI 兼容模型可使用 Chat Completions。组件默认选择 Chat Completions，列表按公开目录声明的接口筛选。若 Responses 下没有列出目标模型，可按下方手动示例配置已确认支持 Responses 的模型。
添加第三方 URL 和模型
创建~/.pi/agent/models.json；Windows 默认路径为 %USERPROFILE%\.pi\agent\models.json。如果文件已存在，把 bettertoken 条目合并到现有的 providers 中。
如果不使用上方生成的配置，也可以手动填写下面的 Responses API 示例。把 YOUR_MODEL_ID 替换为模型广场中的模型 ID，保留 $BETTERTOKEN_API_KEY 作为环境变量引用：
baseUrl 和 api，按以下组合填写：
选择支持该模型工具调用的接口。例如，GPT-6.1 Sol 使用 Responses API。Base URL 保留到表中的层级，由 Pi 拼接具体请求路径。
启动 Pi
在项目目录执行，使用你填写的模型 ID：验证连接
先运行pi --list-models，确认列表中出现 bettertoken 和对应模型。随后启动 Pi 并发送：
PI_OK 后，继续测试一个小型只读任务，确认模型能正常调用工具。
切换模型
在models 数组中添加模型条目，然后在 Pi 中运行 /model。Pi 会重新读取 models.json；选择模型后，可按 Ctrl+S 将它保存为新会话的默认模型。不同接口使用不同的本地配置名称，并在各自条目中设置 api 和 baseUrl。
常见错误
进阶配置
需要图片输入、推理档位或更长上下文时，按模型实际能力补充input、reasoning、contextWindow 和 maxTokens。模型选择可参考模型选择指南。
技术说明
providers 和 --provider 是 Pi 的客户端配置字段，bettertoken 是本页使用的本地名称。Pi 会先使用命令行 --api-key，再使用 auth.json 中保存的凭据，然后读取 models.json 的 apiKey。如果同名配置保存过旧凭据，在 Pi 中通过 /logout 移除对应条目后再连接。