如何将 Oh My Pi (OMP) 接入 ApiClo

开始之前

• 创建独立的 ApiClo API 密钥，检查余额和所选模型当前费率。
• 使用与参考文档相符的客户端版本，不要把密钥存入项目文件。

操作步骤

1. 连接设置

   启动 omp 前设置 APICLO_API_KEY。在 models.yml 中按下方示例添加 apiclo，保留已有供应商。

2. 模型与认证

   从 ApiClo 当前模型表添加准确 ID。支持视觉的模型可声明 input: [text, image]，不要照搬其他模型的上下文或输出限制。

3. 验证

   运行 omp models find apiclo 并选择模型。即使密钥正确，被禁用的供应商也不会出现，请检查 disabledProviders。

示例

export APICLO_API_KEY="YOUR_APICLO_KEY"

$env:APICLO_API_KEY="YOUR_APICLO_KEY"

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 是独立网关。客户端接入不包含该客户端的订阅，也不保证所有功能。应按当前模型费率比较普通输入、缓存读取、缓存写入和输出；命中与节省取决于实际负载。

参考资料

• Oh My Pi (OMP)