集成Pi

Pi

Pi 编程智能体(npm 包 @earendil-works/pi-coding-agent)从它的 models.json 读取自定义服务商。我们的服务商使用 Pi 的 openai-completions API 连接 https://api.abliteratedllm.dev/v1。

占位符:$API_BASE 为 https://api.abliteratedllm.dev/v1,$API_ORIGIN 为 https://api.abliteratedllm.dev,$YOUR_KEY 为你的 API 密钥。

已登录?API 密钥页面为我们当前提供的每个模型准备好了这个文件,附带实时价格、高亮显示的服务商配置块和下载按钮。

1. 在 models.json 中添加服务商

该文件在 macOS 和 Linux 上为 ~/.pi/agent/models.json,在 Windows 上为 %USERPROFILE%\.pi\agent\models.json。如果你设置了 PI_CODING_AGENT_DIR,则为该目录下的 models.json。

json
{
  "$schema": "https://pi.dev/schemas/models.schema.json",
  "providers": {
    "abliteratedllm": {
      "name": "AbliteratedLLM",
      "baseUrl": "$API_BASE",
      "api": "openai-completions",
      "apiKey": "$ABLITERATEDLLM_API_KEY",
      "compat": {
        "supportsDeveloperRole": false,
        "supportsStore": false,
        "supportsReasoningEffort": true,
        "maxTokensField": "max_tokens",
        "thinkingFormat": "openai"
      },
      "models": [
        {
          "id": "glm-5.3-flash-abliterated",
          "name": "GLM-5.3 Flash Abliterated",
          "reasoning": true,
          "thinkingLevelMap": {
            "minimal": null
          },
          "input": [
            "text",
            "image"
          ],
          "contextWindow": 1048576,
          "maxTokens": 131072,
          "cost": {
            "input": 0.0977,
            "output": 0.3421,
            "cacheRead": 0.0098,
            "cacheWrite": 0
          }
        }
      ]
    }
  }
}
  • 新文件:按原样保存。已有文件:只把 "abliteratedllm" 条目复制到你的 "providers" 对象中,用逗号与它前面的服务商隔开,并保留你的其他服务商。
  • api: "openai-completions" 让 Pi 调用 /v1/chat/completions。baseUrl 包含 /v1。
  • compat 要求使用标准的 chat completions 格式:系统提示词作为 system 消息发送,不带 store 字段,输出预算写在 max_tokens 中,推理强度通过 reasoning_effort 设置。
  • models 需要为 GET /v1/models 中的每个 ID 各写一个条目,且 id 必须完全一致;控制台中的文件已经全部列出。contextWindow 和 maxTokens 是该模型的 context_length 和 max_output_tokens。在试用账户上,无论如何设置,输出上限都是 4096 个 token。
  • thinkingLevelMap 隐藏了 Pi 的 minimal 思考级别,因为它没有对应的 reasoning_effort 值。low、medium 和 high 按原值发送。
  • cost 以每百万 token 的美元价格表示(输入、输出和缓存输入),这样 Pi 显示的费用与我们的计费一致。缓存写入不收费。
  • 每次打开 /model 时,Pi 都会重新读取该文件,因此修改后无需重启。

2. 配置密钥

"apiKey": "$ABLITERATEDLLM_API_KEY" 让 Pi 从该环境变量读取你的密钥,因此密钥永远不会写进文件。

Bash 或 Zsh(把这一行加到 ~/.zshrc 或 ~/.bashrc 中即可长期保留):

bash
export ABLITERATEDLLM_API_KEY="$YOUR_KEY"

Windows(对之后打开的终端生效):

powershell
setx ABLITERATEDLLM_API_KEY "$YOUR_KEY"

如果只运行一次,可以在第 3 步的 pi --model … 命令中加上 --api-key "$YOUR_KEY";它会覆盖文件中的设置。只有成功解析到密钥后,我们的模型才会出现在 /model 中。

3. 选择模型,打个招呼

bash
pi --model abliteratedllm/glm-5.3-flash-abliterated

pi --provider abliteratedllm --model glm-5.3-flash-abliterated 的效果相同。在 Pi 中,/model 用于切换模型,在其中按 Ctrl+S 可把你的选择保存为默认模型。pi --list-models 会列出 Pi 能使用的所有模型。

注意事项

  • 图像:图像输入仅适用于 GET /v1/models 中 input_modalities 包含 image 的模型;控制台中的文件会把这些模型的 input 设为 ["text", "image"]。如果你之前已经配置过此模型,刷新或下载 models.json 并合并更新后的模型条目,这样 Pi 才会允许图像附件。使用其他模型时,图像会以 400 unsupported_content 失败。
  • 试用账户只允许 1 个并发请求,对智能体工作来说比较紧张。参见速率限制与试用。

已于 2026 年 11 月 3 日对照 Pi 文档核实:Custom models、CLI 和 models.json schema。