如何将 Oh My Pi (OMP) 接入 ApiClo
Oh My Pi 通过 ~/.omp/agent/models.yml 配置 ApiClo。设置 baseUrl=https://apiclo.com/v1、api=openai-completions,apiKey 填环境变量名 APICLO_API_KEY。OMP 与 Pi 使用不同的配置文件和密钥语法。
用自己的问题试试 ApiClo
第一次使用?点击“免费试用”,注册后在“礼物”页面完成快速检查。符合活动条件的新用户可以转动一次转盘,赢取用于提问的服务额度。
查看礼物领取条件开始之前
- 创建独立的 ApiClo API 密钥,检查余额和所选模型当前费率。
- 使用与参考文档相符的客户端版本,不要把密钥存入项目文件。
操作步骤
连接设置
启动 omp 前设置 APICLO_API_KEY。在 models.yml 中按下方示例添加 apiclo,保留已有供应商。
模型与认证
从 ApiClo 当前模型表添加准确 ID。支持视觉的模型可声明 input: [text, image],不要照搬其他模型的上下文或输出限制。
验证
运行 omp models apiclo 并选择模型。即使密钥正确,被禁用的供应商也不会出现,请检查 disabledProviders。
示例
macOS / Linux
export APICLO_API_KEY="YOUR_APICLO_KEY"
Windows PowerShell
$env:APICLO_API_KEY="YOUR_APICLO_KEY"
~/.omp/agent/models.yml
providers:
apiclo:
baseUrl: https://apiclo.com/v1
api: openai-completions
apiKey: APICLO_API_KEY
models:
- id: claude-sonnet-5
name: Claude Sonnet 5
input: [text, image]
检查结果
发送一次小请求,在 ApiClo Logs 中核对准确模型、结果和扣费用量。分别验证工具和图片。客户端缓存设置不证明命中,应检查实际缓存读取与写入 token。
常见问题
- 如果 apiKey 对应的环境变量不存在,OMP 会把变量名当作密钥原文。请先设置 APICLO_API_KEY;YAML 有效不代表认证成功。
- 401 时检查有效密钥及凭据来源,404 时检查请求地址与模型 ID。向支持提供去除秘密信息的错误正文。
兼容性与计费
ApiClo 是独立网关。客户端接入不包含该客户端的订阅,也不保证所有功能。应按当前模型费率比较普通输入、缓存读取、缓存写入和输出;命中与节省取决于实际负载。
全部文档查看验证,也亲自测试。
查看原始报告,或使用自己的 ApiClo 密钥重新测试。