如何将 OpenCode 接入 ApiClo

开始之前

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

操作步骤

1. 连接设置

   让 OpenCode 服务进程读取 APICLO_API_KEY。v2 在 providers.apiclo 中设置 package 为 @opencode/ai/providers/openai-compatible、env 为 [APICLO_API_KEY]、settings.baseURL 为 https://apiclo.com/v1。

2. 模型与认证

   添加 models 条目，将 modelID 设为准确的 ApiClo 模型 ID，然后选择 apiclo/<alias>。供应商前缀用于 OpenCode 内部选择，发送给上游的仍是 ApiClo 模型 ID。

3. 验证

   v1 使用 provider/npm/options，不能混用 v2 的 providers/package/settings。分别测试文本、工具和图片，仅为实际支持视觉的模型启用相关能力。

示例

export APICLO_API_KEY="YOUR_APICLO_KEY"

$env:APICLO_API_KEY="YOUR_APICLO_KEY"

{
  "$schema": "https://opencode.ai/config.json",
  "model": "apiclo/sonnet",
  "providers": {
    "apiclo": {
      "env": ["APICLO_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {"baseURL": "https://apiclo.com/v1"},
      "models": {"sonnet": {"modelID": "claude-sonnet-5"}}
    }
  }
}

检查结果

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

常见问题

• 供应商配置错误可能来自 v1/v2 字段混用。供应商不可用时，检查密钥是否传给服务进程，而不只是另一个终端。
• 401 时检查有效密钥及凭据来源，404 时检查请求地址与模型 ID。向支持提供去除秘密信息的错误正文。

兼容性与计费

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

参考资料

• OpenCode
• OpenCode v1