Pi - 火山方舟文档

本文介绍如何在 Pi 中配置并使用方舟按量计费模型服务。

前提条件#

在配置工具前，需要开通所需的模型服务。
安装 Node.js 20 或更新版本。

安装 Pi#

在命令行界面，执行以下命令安装 Pi。

1
2
3
4
5# 方式 1：npm 全局安装
npm install -g @earendil-works/pi-coding-agent

# 方式 2：官方一键脚本
curl -fsSL https://pi.dev/install.sh | sh

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

1pi --version

需先额外安装 Git for Windows，Pi 依赖其提供的 bash.exe 执行 ! / !! shell 命令；官方 curl 一键脚本在 Windows 上不支持。

通过 npm 全局安装：

1npm install -g @earendil-works/pi-coding-agent

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

1pi --version

配置 Pi#

手动配置#

关注的配置信息如下：
- <ARK_API_KEY>：替换为您自己的 API Key。
- model：更新为需要使用的 Model ID，模型列表参见模型列表。

创建并编辑 ~/.pi/agent/models.json 文件。如目录不存在，先创建后再编辑。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17{
  "providers": {
    "ark-model": {
      "api": "openai-responses",
      "apiKey": "<ARK_API_KEY>",
      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
      "models": [
        {
          "contextWindow": 1048576,
          "id": "doubao-seed-evolving",
          "input": ["text", "image"],
          "maxTokens": 256000
        }
      ]
    }
  }
}

使用 Pi#

进入项目目录并启动 Pi：
Bash
```
1pi
```
在 Pi 交互界面执行 /model，可选择切换刚才配置的 provider 和模型。
模型列表参见模型列表。
发送任意问题验证连通性，例如：
```
简单介绍一下当前目录的文件结构。
```
若返回内容正常，说明按量计费模型服务已成功接入。

更多 Pi 使用教程请参见 Pi 官方文档。