如何将 Crush 接入 ApiClo
在当前 Crush 的全局 crushrc 中添加 openai-compat 类型的 ApiClo 供应商，地址为 https://apiclo.com/v1，密钥来自 APICLO_API_KEY。当前配置使用 Crush 内置 Bash 命令，旧 JSON 示例属于另一种配置格式。
开始之前
- 创建独立的 ApiClo API 密钥，检查余额和所选模型当前费率。
- 使用与参考文档相符的客户端版本，不要把密钥存入项目文件。
操作步骤
连接设置
Unix 使用 ~/.config/crush/crushrc，Windows 使用 %USERPROFILE%\.config\crush\crushrc。将 provider 命令写入该文件，不要当作普通 PowerShell 命令执行。
模型与认证
启动 Crush 前设置 APICLO_API_KEY。使用 model add 注册准确的 ApiClo 模型 ID，再用 model large 选择它。
验证
仅为支持图片的模型设置 --supports-images true。先测试小型文本任务，再分别测试工具调用和附带文字问题的图片。
示例
macOS / Linux
export APICLO_API_KEY="YOUR_APICLO_KEY"Windows PowerShell
$env:APICLO_API_KEY="YOUR_APICLO_KEY"crushrc
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 是独立网关。客户端接入不包含该客户端的订阅，也不保证所有功能。应按当前模型费率比较普通输入、缓存读取、缓存写入和输出；命中与节省取决于实际负载。
全部文档