如何将 Goose 接入 ApiClo

开始之前

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

操作步骤

1. 连接设置

   在 Configure providers 中添加名为 ApiClo 的 OpenAI Compatible 自定义供应商并启用认证。需要完整请求地址时，填写 https://apiclo.com/v1/chat/completions。

2. 模型与认证

   若使用 Goose 内置 OpenAI 供应商，则设置 OPENAI_HOST=https://apiclo.com、OPENAI_BASE_PATH=v1/chat/completions，不要在两个字段重复路径。

3. 验证

   添加所选模型 ID，支持时启用流式回复，并验证简短文本。工具与图片传递需单独测试，创建自定义供应商并不证明视觉能力可用。

检查结果

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

常见问题

• 404 可能来自错误的请求路径。密钥被忽略时请使用供应商的凭据配置，不要假设粘贴到 config.yaml 的秘密值会作为 API 密钥读取。
• 401 时检查有效密钥及凭据来源，404 时检查请求地址与模型 ID。向支持提供去除秘密信息的错误正文。

兼容性与计费

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

参考资料

• Goose