Pi Coding Agent | 文档中心

一、通用准备

在接入 AI 工具前，请先完成以下准备工作。

1.获取 API Key

平台支持按量付费/模型资源包、Token Plan 两种计费方式，对应的凭证获取方式不同：

使用方式

说明

获取方式（以下 API Key 均为示例）

按量付费 API 调用

按实际使用量计费，适合轻度使用

Base URL OpenAI 兼容协议：https://maas-api.unisound.com/v1 Anthropic 兼容协议：https://maas-api.unisound.com/anthropic
API Key
格式：sk-xxxxx

前往 API Key 管理创建 API Key

Token Plan

固定订阅费，按套餐限量调用

Base URL OpenAI 兼容协议：https://maas-api.unisound.com/v1 Anthropic 兼容协议：https://maas-api.unisound.com/anthropic
API Key
格式：tp-xxxxx

成功订阅Token Plan 后，前往订阅管理获取专属 API Key

按量付费支持使用所有模态模型，包括文本、语音、视觉等。

Token Plan Key 用于 Token Plan 额度。它可以在付费资源可用之前就存在；当您拥有 Token Plan Credits 时才可实际使用资源。详情见 Token Plan 订阅概要。

二、安装 Pi Coding Agent

安装或更新 Node.js（v22.19 或更高版本）。
在终端中执行下列命令，安装 Pi Coding Agent。

Bash

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

运行以下命令验证安装。若有版本号输出，则表示安装成功。

Bash

pi --version

三、配置接入凭证

编辑或新建 ~/.pi/agent/models.json（Windows 路径：C:\Users\<用户名>\.pi\agent\models.json），写入以下配置。

将 UNISOUND_API_KEY 替换为你的 API Key。

JSON

{
  "providers": {
    "unisound": {
      "baseUrl": "https://maas-api.unisound.com/v1",
      "api": "openai-completions",
      "apiKey": "UNISOUND_API_KEY",
      "models": [
        {
          "id": "u2-flash",
          "name": "U2-Flash"
        }
      ]
    }
  }
}

如需调整上下文与输出上限，可在模型中追加 contextWindow 与 maxTokens 字段，取值请按目标模型的参数说明填写。

API Key 的获取方式与 Key 格式参见通用准备。

配置保存后，进入项目目录执行 pi 启动。输入 /model（或按 Ctrl+L）打开模型选择器，选择 unisound 下的目标模型即可使用，选中后按 Ctrl+S 可将其保存为默认模型。