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 URLhttps://api.kkaiapi.com/v1
模型 IDclaude-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、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。