如何将 Pi 接入 ApiClo

开始之前

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

操作步骤

1. 连接设置

   在启动 Pi 的终端中设置 APICLO_API_KEY。添加下方 JSON 供应商，不要覆盖其他供应商。

2. 模型与认证

   使用准确的 ApiClo 模型 ID，仅为视觉模型声明 image。在 /model 中选择 apiclo/claude-sonnet-5 或自己的模型条目。

3. 验证

   若旧凭据覆盖了新密钥，请检查 Pi 的供应商认证设置。先测试简短回复，再分别测试一次工具调用和图片请求。

示例

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", "input": ["text", "image"]}]
    }
  }
}

检查结果

发送一次小请求，在 ApiClo Logs 中核对准确模型、结果和扣费用量。分别验证工具和图片。客户端缓存设置不证明命中，应检查实际缓存读取与写入 token。

常见问题

• 模型可以从 JSON 加载，但没有可用凭据时仍无法选择。与 OMP 示例不同，Pi 的环境变量插值明确使用 $APICLO_API_KEY。
• 401 时检查有效密钥及凭据来源，404 时检查请求地址与模型 ID。向支持提供去除秘密信息的错误正文。

兼容性与计费

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

参考资料

• Pi