跳到主要内容

Cline

Cline 支持配置自定义基础 URL、API Key 和模型 ID 的兼容 OpenAI 服务提供方。当 Cline 需要通过 AISIX 发送模型请求时，应选择这一服务提供方类型。

本指南将 Cline 配置为使用 AISIX 调用方 API Key 调用 AISIX 兼容 OpenAI 的代理 API。Cline 中的模型 ID 应填写 AISIX 模型别名。此配置使请求端点、API Key 和模型别名均由 AISIX 控制。

前置条件​

开始前，请准备以下内容：

  • 已在编辑器中安装 Cline。
  • 一个代理监听器可用的运行中 AISIX 网关。
  • 一个 AISIX 调用方 API Key。
  • 一个可通过兼容 OpenAI 的 API访问的模型别名。

配置 Cline​

打开 Cline 设置，选择兼容 OpenAI 的服务提供方，然后设置以下值：

Cline 设置AISIX 值
API 服务提供方OpenAI Compatible
基础 URLhttp://127.0.0.1:3000/v1
API KeyYOUR_CALLER_API_KEY
模型 IDgpt-4o-prod

请替换为实际的 AISIX 代理 URL、调用方 API Key 和模型别名。Cline 发送的模型 ID 是 AISIX 别名，而不是上游服务提供方模型 ID。

Cline 还提供 OpenAI 特定的服务提供方选项。经网关路由的流量请选择 OpenAI Compatible。基于 OpenAI 账号和 OAuth 的服务提供方路径可能绕过 AISIX 策略。

验证集成​

使用 Cline 的服务提供方验证操作确认端点、Key 和模型别名，然后从 Cline 发送一条简短提示词。

请求成功后，请确认以下结果：

  • Cline 输出模型响应。
  • AISIX 为所选模型别名记录一条成功的 POST /v1/chat/completions 请求。

AISIX 会验证调用方 API Key、检查模型访问权限、解析模型别名、应用策略，并将请求分发到别名背后的上游服务提供方。

如果请求失败，请检查以下内容：

现象检查项
认证失败确认 Cline 中的 API Key 是 AISIX 调用方 API Key。
找不到模型确认 Cline 中的模型 ID 是该调用方 API Key 可见的 AISIX 模型别名。
Cline 报告路由或请求体错误确认所选模型别名支持兼容 OpenAI 的聊天请求。
请求绕过 AISIX确认基础 URL 指向 AISIX 代理 API 根路径，并包含 /v1。

添加网关策略​

Cline 流量到达 AISIX 后，可使用与其他兼容 OpenAI 客户端相同的控制措施：

后续步骤​