@oma-home/pi-bailian

English | 简体中文

@oma-home/pi-bailian = pi × OhMyAgent × 阿里云百炼。

一个 pi 扩展，注册**阿里云百炼（DashScope）**模型 Provider，提供精选模型目录与多 API Key 管理能力。

百炼不是 pi 的内置 Provider。pi 内置的是 qwen-token-plan / qwen-token-plan-cn 订阅产品，不覆盖百炼通用的 OpenAI 兼容端点。本扩展补上这个缺口，并修掉手写 models.json 时会踩的两个坑。

为什么需要这个扩展？

1. developer role 400 报错 — pi 的 openai-completions 发送器默认用新版 OpenAI 的 developer 系统角色，百炼只认 system，不做处理的话每个请求都报 developer is not one of [...]。本扩展给每个模型设 supportsDeveloperRole: false，让 pi 改发 system。

2. 思考模型不输出推理流 — 百炼的思考模型（Qwen3.x / DeepSeek-V4 / GLM-5.x / Kimi-K2.x / MiniMax-M2.x）用顶层 enable_thinking 字段开关，并以 reasoning_content 流式返回推理——两者都不是 OpenAI 标准。本扩展接上 thinkingFormat: "qwen" + requiresReasoningContentOnAssistantMessages: true，推理开箱即用。

3. 多 API Key 管理 — 支持配置多个百炼 API Key，每个 Key 可命名并自定义可用模型列表。通过 /bailian 命令一键切换，即时生效。

快速开始

安装

# 从 npm 安装（推荐）
pi install npm:@oma-home/pi-bailian

# 从 GitHub 安装
pi install git:github.com/oma-home/pi-bailian

# 本地开发测试
pi -e /path/to/pi-bailian

配置 API Key

方式一：多 Key 管理（推荐）

在 pi 会话中运行 /bailian → Add API Key，交互式配置：

1. 输入 Key 名称（如 zhangsan）
2. 输入 API Key（在 百炼控制台 → API-KEY 获取）
3. 勾选该 Key 可用的模型（多选）
4. 保存，自动生效

配置存储在 ~/.pi/agent/bailian-keys.json：

{
  "active": "zhangsan",
  "keys": [
    {
      "name": "zhangsan",
      "apiKey": "sk-xxxxxxxx",
      "models": ["glm-5.2", "kimi-k2.7-code", "qwen3.7-plus"]
    },
    {
      "name": "lisi",
      "apiKey": "sk-bbbbbbbb",
      "models": ["deepseek-v4-pro", "qwen3.7-max"]
    }
  ]
}

切换 Key：/bailian → Switch API Key，选择后即时生效。

方式二：环境变量（单 Key）

export DASHSCOPE_API_KEY=sk-xxxxxxxx

不创建配置文件时，自动回退到此方式，所有模型可用。

使用

# 命令行指定
pi --provider bailian --model qwen3.7-plus

# 会话中交互选择
/model              # 从 bailian/* 条目中选
/bailian            # 管理 API Key

精选模型目录

9 个精选模型，逐个对照百炼官方文档核实（2026-07）。定价为华北2（北京）原价（元/百万 token），非限时折扣价。

模型 ID	上下文	推理	输入	输入 / 输出（¥/M）	缓存
deepseek-v4-pro	1M	✅	文本	12 / 24	✓
deepseek-v4-flash	1M	✅	文本	1 / 2	✓
glm-5.2	1M	✅	文本	8 / 28	—
kimi-k2.6	256K	✅	文本+图片	6.5 / 27	✓
kimi-k2.7-code	256K	✅（仅思考）	文本+图片	6.5 / 27	✓
MiniMax-M2.5	192K	✅（仅思考）	文本	2.1 / 8.4	—
qwen3.7-flash	1M	✅	文本	0.2 / 0.8	✓
qwen3.7-max	1M	✅	文本	12 / 36	✓
qwen3.7-plus	1M	✅	文本	2 / 8	✓

缓存定价

标 ✓（支持百炼上下文缓存）的模型，按官方缓存计费规则：

• cacheRead = 输入价的 10%
• cacheWrite = 输入价的 125%

关于 maxTokens

官方未逐模型公布最大输出值，maxTokens 按模型档位给了保守默认值。如需更长单次输出，在 index.ts 中修改 MODELS 数组。

端点

https://dashscope.aliyuncs.com/compatible-mode/v1

百炼的 OpenAI 兼容 Chat Completions 端点。请求携带 Authorization: Bearer <api-key>。

命令参考

命令	说明
/bailian	打开 API Key 管理菜单
├ Switch API Key	切换当前使用的 API Key
├ Add API Key	添加新的 API Key（命名 + 选模型）
└ Remove API Key	删除已配置的 API Key

开发

git clone https://github.com/oma-home/pi-bailian.git
cd pi-bailian
npm install          # 安装 typecheck 依赖
npx tsc --noEmit     # 类型检查
pi -e .              # 本地测试

数据来源

• 模型大全功能规格与计费
• 文本生成
• 深度思考模型用法
• 限流

License

MIT

---

由 OhMyAgent 构建 — 你的 AI 指挥中心。