Cline 接入教程

按照 KunAI 的 Cline 接入教程配置 OpenAI 兼容 Base URL、API Key 与模型，并验证对话和工具调用。

配置步骤

  1. 打开 Cline 设置，并将 API Provider 选择为 OpenAI Compatible。
  2. 将 Base URL 设置为 https://kunai.one/v1，并确认地址中没有重复的路径。
  3. 填入 KunAI 的 API Key，再通过 GET https://kunai.one/v1/models 选择一个精确的模型 ID。
  4. 保存配置后新建一个对话发送测试消息，确认响应、用量记录和计费均正常。

兼容性说明

Cline 的 Base URL 需要包含 /v1；模型名称必须与模型列表返回的 ID 完全一致。

常见问题排查

  • 出现 401 时，检查 API Key 是否有效以及 Authorization Bearer 格式是否正确。
  • 出现 404 或 model not found 时，重新读取 /v1/models 并核对 Base URL 与模型 ID。
  • 出现 429 时，检查访问频率、客户端并发设置和响应中的 Retry-After 提示。
  • 出现 502 Upstream request failed 时，先用新对话验证基础请求，再检查所选模型与服务状态。

继续阅读