Pi 配置教程

把 QuickRouter 加入 Pi 配置,在模型列表中选择实际使用的模型。

先安装 Pi,并创建 QuickRouter API Key。

推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。

使用 QuickRouter Switch 配置

还没安装?下载并安装 QuickRouter Switch。

  1. 添加供应商

    打开 QuickRouter Switch,在左边选「Pi」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对 Pi 的接口格式与 Base URL。
    图 19 填写 API Key,核对 Pi 的接口格式与 Base URL。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 20 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「启用」。重开 Pi,在模型选择器中选 QuickRouter 和你要用的模型。

查看具体参数和更多操作

「供应商标识」保留 quickrouter,「Base URL」用 https://api.quickrouter.ai/v1。接口格式保留「OpenAI Chat Completions」。 模型预填 gpt-6.1-sol。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 QuickRouter 仍在「可添加」区,再点卡片上的「启用」,使其进入「已添加」。 重开 Pi,在模型选择器选择 QuickRouter 下的模型。例如使用 pi --model quickrouter/gpt-6.1-sol,模型 ID 换成你实际配置的值。

使用 CC-Switch 配置

还没安装?下载并安装 CC-Switch。

  1. 添加供应商

    打开 CC Switch,在左侧选择Pi,点击添加供应商,选择自定义配置。

  2. 填写连接信息
    • 供应商标识填 quickrouter,名称填 QuickRouter;新增时设置标识,编辑时不可更改。
    • 接口格式选 OpenAI Chat Completions,API Key 填自己的令牌,Base URL 填 https://api.quickrouter.ai/v1。
    Pi 的自定义供应商与 OpenAI Chat Completions 模型配置
    Pi:供应商标识 quickrouter,接口格式 OpenAI Chat Completions,显示名称 gpt-6-sol。
  3. 设置模型
    • 找到模型区,点击「添加模型」新增一行。
    • 至少添加一个模型,ID 填 gpt-6-sol,显示名称填 gpt-6-sol。

    示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。

  4. 保存供应商

    在表单底部点添加,确认 Pi 的供应商列表出现 QuickRouter 卡片。

  5. 启用并打开工具

    本节直接写入客户端配置。

    如果卡片在「可添加」,点卡片上的启用,确认移到「已添加」。在终端重新运行 pi 开始新会话,输入 /model,选择 QuickRouter 下的 gpt-6-sol 或你实际填写的模型。

    Pi 的 CC Switch 供应商界面截图
    在「可添加」里点 QuickRouter 右侧的「启用」,再打开 Pi 选模型。
  6. 发送消息验证

    在新会话里发送「请只回复 OK」。收到回复后,到 QuickRouter 使用日志核对请求时间和模型 ID。

查看配置细节与排错

配置写入 ~/.pi/agent/models.json 的 providers.quickrouter。若已有卡片尚未加入客户端配置,可点击卡片的启用后再在 Pi 中选模型。CC Switch 不修改 Pi 的 defaultProvider 或 defaultModel,本节无需本地路由。

确认配置生效

打开 Pi 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。

返回工具教程列表

在线客服