第二部分，模型与 Providers

models.json 与自定义模型

在 models.json 中连接 Ollama、vLLM、LM Studio 和 OpenAI 兼容 API，并声明兼容性能力。

进阶 / 13 分钟 / 第 12 篇

最小本地 Provider

~/.pi/agent/models.json 可以添加非内置 Provider 和模型。每个模型至少需要 id，Provider 需要 baseUrl、API 类型和可解析凭据。

许多本地服务器使用 openai-completions 兼容层，但不一定支持 developer role 或 reasoning_effort。compat 字段应准确描述真实能力。

{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "ollama",
      "compat": {
        "supportsDeveloperRole": false,
        "supportsReasoningEffort": false
      },
      "models": [{ "id": "qwen2.5-coder:7b" }]
    }
  }
}

安全解析密钥

apiKey 和 headers 支持环境变量插值或外部命令。生产中优先引用密钥管理工具，不在 JSON 写明文。

编辑 models.json 后重新打开 /model 即可刷新。为每个模型记录 contextWindow、maxTokens、输入类型和成本，避免错误预算。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。

Pi Custom Models