PiAgent 接入 kkaiapi
最后更新:
为 Pi Coding Agent 合并 models.json 自定义 provider,选择 openai-completions,安全读取环境变量并通过 /model 重载模型。
为 Pi Coding Agent 添加 models.json
本页的 PiAgent 指 Pi Coding Agent。合并下面 providers 片段到 ~/.pi/agent/models.json,以 openai-completions 选择兼容适配器;API Key 使用环境变量插值,不能把变量名当作字面密钥。
| 配置项 | 值 |
|---|---|
| 协议 | OpenAI Chat Completions |
| Base URL | https://api.kkaiapi.com/v1 |
| 模型 ID | claude-sonnet-5-5 |
| 凭据 | 从当前工具进程的安全配置读取 |
合并配置片段
配置中只引用环境变量;应合并到现有配置,保留已有账户与其他模型条目。
{
"providers": {
"kkai": {
"baseUrl": "https://api.kkaiapi.com/v1",
"api": "openai-completions",
"apiKey": "${KKAI_API_KEY}",
"models": [
{
"id": "claude-sonnet-5-5"
}
]
}
}
}核对实际生效的工具路径
让启动 Pi 的进程取得 KKAI_API_KEY,打开 /model 重新加载配置并选择 kkai 下的模型。若模型不出现,先查凭据是否可解析。上下文和输出预算按模型文档填写;本地成本元数据不等于 KK 账单。
配置依据与能力验证
配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。
配置字段依据piagent 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。
常见问题
为什么 API 请求成功,工具仍不能完成任务?
继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。