Pi 设置

安装与环境

按 Pi 官方文档安装。在启动 Pi 的终端设置 WUDI_API_KEY。本页使用自定义 API Key 模式。

配置 models.json

在 ~/.pi/agent/models.json 中合并以下内容。Windows 的 ~ 对应当前用户目录。已有 providers 时新增 wudi，不要重复创建整个根对象。

{
  "$schema":"https://pi.dev/schemas/models.schema.json",
  "providers":{
    "wudi":{
      "baseUrl":"https://wudiapi.com/v1",
      "api":"openai-completions",
      "apiKey":"${WUDI_API_KEY}",
      "models":[{"id":"gpt-5.6-sol","name":"GPT · WuDi API"}]
    }
  }
}

这里 ${WUDI_API_KEY} 是环境变量引用，并非把这段文字当作密钥发送。不要用不相关的订阅登录来替代 WuDi Key。

选择模型

启动 Pi，运行 /model 重新加载模型配置并选择 WuDi 模型。先发送一条简短文本请求，再测试需要工具的任务。可用模型列表需要同时满足配置存在与凭据可解析两个条件。

添加能力元数据

只在确认后填写图片输入、思考、上下文等选项。编写了能力标记不会让上游获得该能力。默认示例只声明连接与模型，避免不必要的兼容开关。

排错与恢复

模型不显示：检查 JSON 格式、文件位置与 Key 是否能读取。终端有效但后台失效：检查启动进程环境。端点拒绝参数：核对 api 和目标模型。恢复时移除 providers.wudi 并切回原模型，不用删除全部 Pi 用户数据。

参考：Pi 自定义模型官方说明。