如何将 Crush 接入 ApiClo

开始之前

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

操作步骤

1. 连接设置

   Unix 使用 ~/.config/crush/crushrc，Windows 使用 %USERPROFILE%\.config\crush\crushrc。将 provider 命令写入该文件，不要当作普通 PowerShell 命令执行。

2. 模型与认证

   启动 Crush 前设置 APICLO_API_KEY。使用 model add 注册准确的 ApiClo 模型 ID，再用 model large 选择它。

3. 验证

   仅为支持图片的模型设置 --supports-images true。先测试小型文本任务，再分别测试工具调用和附带文字问题的图片。

示例

export APICLO_API_KEY="YOUR_APICLO_KEY"

$env:APICLO_API_KEY="YOUR_APICLO_KEY"

provider add apiclo --name "ApiClo" --type openai-compat --base-url "https://apiclo.com/v1" --api-key "$APICLO_API_KEY" --discover-models false
model add apiclo/claude-sonnet-5 --name "Claude Sonnet 5" --supports-images true
model large apiclo/claude-sonnet-5

检查结果

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

常见问题

• 不要混用旧 JSON 与当前 crushrc 语法。供应商正常而附件失败时，检查 supports-images 设置及模型实际的图片能力。
• 401 时检查有效密钥及凭据来源，404 时检查请求地址与模型 ID。向支持提供去除秘密信息的错误正文。

兼容性与计费

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

参考资料

• Crush