第三方接入

CatAPI 支持多个第三方客户端接入，包括 OpenCode、OpenClaw、Hermes、Cline 等。参考：第三方教程。

通用配置模型

大多数第三方客户端都可以抽象成四个字段：

字段内容
Provider选择 OpenAI、Anthropic、Gemini 或自定义兼容接口。
API KeyCatAPI 后台创建的令牌。
Base URLhttps://api.catapi.com 或客户端要求的 /v1 地址。
Model当前 Provider 分组下可用模型。

OpenCode

OpenCode 适合通过自定义 provider 接入。配置时重点检查：

  • Provider 类型是否和模型分组匹配。
  • Base URL 是否使用 CatAPI。
  • 模型名是否来自 Codex/OpenAI 或 Claude 方向的可用列表。

OpenClaw

OpenClaw 的接入重点是兼容接口和模型名映射。遇到模型错误时，优先检查客户端是否对模型名做了自动转换。

Hermes

Hermes 通常需要在配置文件或 UI 中新增自定义服务。建议为 Hermes 单独创建一个 CatAPI 令牌，便于后续统计和停用。

Cline

Cline 在 VS Code 内运行，配置后需要注意：

  • VS Code 是否读取到了最新环境变量。
  • Provider 是否选到了自定义兼容接口。
  • 如果使用代理，VS Code 和终端代理配置可能不一致。

第三方客户端排查清单

  1. 客户端请求的最终 URL。
  2. Header 中是否携带 CatAPI 令牌。
  3. 请求体中的 model 字段。
  4. 客户端是否支持当前接口类型。
  5. 本地代理或企业网络是否改写了请求。