Pi · OptiWaves

在 models.json 中注册 OptiWaves，并设置 provider、模型和思考等级。

先按准备 API Key设置 OPTIWAVES_API_KEY。以下配置适用于 Pi 0.85.0。

1. 注册模型

系统	文件位置
macOS / Linux	`~/.pi/agent/models.json`
Windows	`%USERPROFILE%\.pi\agent\models.json`

若设置过 PI_CODING_AGENT_DIR，则编辑该目录下的 models.json。合并以下 provider：

models.json

{
  "providers": {
    "optiwaves": {
      "baseUrl": "https://api.optiwaves.app/v1",
      "apiKey": "$OPTIWAVES_API_KEY",
      "api": "openai-responses",
      "models": [
        {
          "id": "auto",
          "name": "OptiWaves Auto",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 500000,
          "maxTokens": 65536
        }
      ]
    }
  }
}

apiKey 中的 $ 表示读取环境变量。单独写 OPTIWAVES_API_KEY 会被当作字面值，而不是变量引用。Pi 的字段是 baseUrl，注意与其他客户端的 baseURL 区别。

2. 设置默认选择

在同目录的 settings.json 中合并：

settings.json

{
  "defaultProvider": "optiwaves",
  "defaultModel": "auto",
  "defaultThinkingLevel": "medium"
}

3. 启动并验证

pi --provider optiwaves --model auto --thinking medium

在 Pi 中用 /model 查看模型，发送一个简短的文本问题验证回答。新版 Pi 会在打开 /model 时重新加载自定义模型文件；重新启动也可以确保使用最新配置。

4. 切换模型

需要多个可选模型时，在 models 数组中保留 auto 并新增其他模型描述。例如增加 Auto Fast 时使用 id: "auto-fast"，上下文和最大输出与 Auto 相同，再运行：

pi --provider optiwaves --model auto-fast

Auto Fast 无需单独设置思考档位。添加其他模型时，按模型与价格填写窗口和图片支持范围。

常见问题

情况	检查
模型未出现在可用列表	provider 是否有正确的密钥引用，环境变量是否在当前进程中存在
仍选中旧模型	使用本页完整命令，或在 `/model` 中重新选择
图片在本地被拒绝	Auto 模型描述应包含 `input: ["text", "image"]`

参考 Pi 自定义模型文档。返回客户端选择。

本地记忆

API 接通后，可用 OptiWaves CLI 为这个客户端配置本地记忆：

optiwaves memory --client pi

重启客户端后，用一次保存和一次新会话召回检查结果。具体路径与限制见本地记忆。