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。
{
"$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 中即可长期保留):
export ABLITERATEDLLM_API_KEY="$YOUR_KEY"Windows(对之后打开的终端生效):
setx ABLITERATEDLLM_API_KEY "$YOUR_KEY"如果只运行一次,可以在第 3 步的 pi --model … 命令中加上 --api-key "$YOUR_KEY";它会覆盖文件中的设置。只有成功解析到密钥后,我们的模型才会出现在 /model 中。
3. 选择模型,打个招呼
pi --model abliteratedllm/glm-5.3-flash-abliteratedpi --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 才会允许图像附件。使用其他模型时,图像会以 400unsupported_content失败。 - 试用账户只允许 1 个并发请求,对智能体工作来说比较紧张。参见速率限制与试用。
已于 2026 年 11 月 3 日对照 Pi 文档核实:Custom models、CLI 和 models.json schema。