pi（pi.dev 编码 Agent）接入免费模型 API：/login 与 models.json 自定义接口配置

准备

• 已安装 pi（官网 pi.dev 提供 curl / PowerShell / npm 等多种安装方式）
• 一个模型平台的 API Key

步骤

1. 01

   安装 pi

   pi.dev 首页给出的安装命令（macOS / Linux），Windows 可用 PowerShell 版本或 npm 安装：

   bash复制

   curl -fsSL https://pi.dev/install.sh | sh
   # 或
   npm install -g --ignore-scripts @earendil-works/pi-coding-agent

2. 02

   内置服务商：/login 后 /model 选模型

   pi 内置 Anthropic、OpenAI、Google、Mistral、Groq、Cerebras、Hugging Face、NVIDIA、OpenRouter 等服务商。官方文档的做法：运行 /login 选服务商、填 Key（保存在 agent 目录的 auth.json），再用 /model 搜索并选择模型，按 Ctrl+S 可设为新会话默认模型。

   本站收录的 NVIDIA、Groq、OpenRouter、Cerebras、Mistral 等免费额度都可以这样直接用。

   text复制

   /login
   /model

3. 03

   国内平台：写 models.json

   pi 文档说明：对于兼容 OpenAI / Anthropic / Google 的接口，把它加进 models.json 即可。用户级配置目录（agent 目录）默认是 ~/.pi/agent，所以文件路径是 ~/.pi/agent/models.json。

   • api 填 openai-completions（OpenAI Chat Completions 兼容）；
   • apiKey 支持 $变量名 形式读取环境变量，避免明文写 Key；
   • models 里的 id 必须是平台的准确模型 ID。

   下面同时配置硅基流动和百炼北京地域（Base URL 分别取自两家官方文档），模型 ID 以各平台模型列表为准：

   json复制

   {
     "providers": {
       "siliconflow": {
         "baseUrl": "https://api.siliconflow.cn/v1",
         "api": "openai-completions",
         "apiKey": "$SILICONFLOW_API_KEY",
         "models": [
           { "id": "Pro/deepseek-ai/DeepSeek-R1" }
         ]
       },
       "bailian": {
         "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
         "api": "openai-completions",
         "apiKey": "$DASHSCOPE_API_KEY",
         "models": [
           { "id": "qwen-plus" }
         ]
       }
     }
   }

4. 04

   设置环境变量并选择模型

   在启动 pi 的那个 shell 里导出 Key（写进 ~/.zshrc / ~/.bashrc 可持久生效），然后启动 pi，打开 /model（会自动重新加载 models.json）选中新模型。

   bash复制

   export SILICONFLOW_API_KEY="你的硅基流动Key"
   export DASHSCOPE_API_KEY="你的百炼Key"
   pi

注意事项

• 模型不出现在 /model 里：pi 文档说明，models.json 里的模型只有在 pi 能解析到凭证时才可选——先确认环境变量在启动 pi 的进程里存在。
• 凭证优先级：命令行 --api-key > auth.json > models.json 的 apiKey > 服务商环境变量。
• 兼容性开关别乱开：pi 文档提醒，compat 设置只应描述你确认过的接口差异，不要只因为平台号称兼容 OpenAI 就打开。
• 百炼新人免费额度只适用于北京地域；SiliconFlow 的免费模型以模型广场标注为准。

常见问题

相关优惠

• 模型 · GroqGroq 免费 API 限速套餐免费档 30 RPM，主力模型 1000 RPD / 8K TPM / 200K TPD，无需信用卡
• 模型 · OpenRouterOpenRouter 免费模型20 请求/分钟，每日 50 次（累计充值 $10 后提升至每日 1000 次）
• 模型 · Mistral AIMistral 免费实验套餐每模型每秒 1 请求，每月约 10 亿 tokens；免信用卡
• 额度 · Hugging FaceHF 每月免费 credits免费账号每月 $0.10 推理 credits（PRO $2/月）
• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效
• 额度 · NVIDIA英伟达 NIM 送 1000 点数注册送 1000 credits

信息来源

• pi.dev 官网pi.dev
• pi 文档 · Choose a Model（models.json）raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/docs/models.md
• pi 文档 · Configuration（agent 目录）raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/docs/configuration.md
• SiliconFlow · Cline（Base URL）docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-cline
• 阿里云百炼 · 获取与配置 API Key（Base URL）help.aliyun.com/zh/model-studio/get-api-key

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准