第三方工具接入
适用角色:开发者 更新日期:2026-08-06
支持自定义 Base URL 的客户端,通常都能通过本平台调用模型。不同工具的字段名称略有差异,但配置内容基本相同:API 地址、API Key、模型调用名和协议类型。
具体工具的逐步操作放在 工具接入指南。本页说明各类工具如何选择地址,以及配置完成后怎样确认请求已正确接入。
准备连接信息
进入控制台的「API Key」页面,创建或选择一把 Key;模型调用名可在「调用指南」中复制。下面以 deepseek-v4-flash 为例;如需使用 kimi-k3,可从调用指南复制对应调用名。
| 配置项 | 填写内容 |
|---|---|
| API Key | 控制台生成的 sk- 开头密钥 |
| 模型调用名 | deepseek-v4-flash、kimi-k3,或调用指南展示的完整调用名 |
| OpenAI Compatible Base URL | https://<接口地址> |
| Chat Completions 完整地址 | https://<接口地址>/v1/chat/completions |
| Messages Compatible Base URL | https://<接口地址> |
| Messages 完整地址 | https://<接口地址>/v1/messages |
大多数工具只要求填写 Base URL,它们会自动拼接 /chat/completions 或 /messages。只有字段明确写着 Endpoint、API URL 或完整接口地址时,才填写完整地址。
按工具类型选择配置
OpenAI Compatible 客户端
Cursor、Cline、Roo Code、Continue、Chatbox、Cherry Studio、Open WebUI、Dify、Coze 等工具都提供 OpenAI Compatible 或 Custom OpenAI 入口。推荐配置如下:
Provider: OpenAI Compatible
Base URL: https://<接口地址>
API Key: YOUR_API_KEY
Model: deepseek-v4-flash客户端会根据协议补充请求路径。若最终请求地址出现重复路径,请确认填写的是上述域名根地址,而不是带端点的完整请求地址。
Messages Compatible 客户端
Claude Code、Hermes Agent 或部分 Agent 框架使用 Messages 格式。这类工具通常填写域名根地址:
Base URL: https://<接口地址>
API Key: YOUR_API_KEY
Model: deepseek-v4-flash工具会在请求时追加 /v1/messages。如果客户端要求完整 Endpoint,则填写 https://<接口地址>/v1/messages。
需要完整接口地址的工具
沉浸式翻译、通用 HTTP 节点和部分低代码平台不会自动补接口路径。它们使用:
https://<接口地址>/v1/chat/completions认证 Header 为:
Authorization: Bearer YOUR_API_KEY工具入口
| 场景 | 工具 | 教程 |
|---|---|---|
| 终端编程 | Claude Code、Codex CLI、Aider、OpenCode、Qwen Code、CodeWhale | 代码和终端 |
| IDE 与插件 | Cursor、Cline、Roo Code、Kilo Code、Continue、Trae、Zed、Windsurf | IDE 和编码插件 |
| 对话客户端 | Chatbox、Cherry Studio、Open WebUI、LobeChat、NextChat | 对话、Agent 和工作流 |
| Agent 与消息渠道 | OpenClaw、Hermes Agent、ChatGPT-on-WeChat | 对话、Agent 和工作流 |
| 工作流与应用开发 | Dify、Coze、n8n、Flowise、LangChain、LiteLLM | 对话、Agent 和工作流 |
| 网页翻译 | 沉浸式翻译 | 沉浸式翻译 |
验证连接
配置保存后,用一条短消息进行测试:
请只回复:连接成功随后检查以下几项:
- 客户端收到正常回复,没有 401、403 或 404;
- 控制台「使用记录」出现一条新记录;
- 记录中的 Key、模型和分组与配置一致;
- Agent 类工具再执行一次简单工具调用,确认文件读写或命令执行能力正常。
聊天能正常回复,但 Agent 无法调用工具时,通常不是连接问题。可以检查模型是否支持工具调用,以及客户端是否启用了对应能力。
常见问题
返回 401
重新复制 API Key,确认输入框中没有空格、换行或重复的 Bearer 前缀。大多数 API Key 输入框只填写 sk-xxx。
返回 403
检查 Key 是否启用、是否过期、是否绑定了可用分组,以及当前用户是否获得该分组。余额或额度不足也可能返回 403,具体以响应中的 code 为准。
返回 404
先看客户端最终请求地址。常见原因是客户端未按协议拼接路径,或者把完整接口地址填进了只接受 Base URL 的字段。
返回 Model Not Found
从控制台「调用指南」重新复制模型名。展示名称和调用名可能不同,配置时应使用调用名。
配置后仍请求原来的服务
完全退出并重启客户端,再检查系统环境变量、用户配置和项目配置。项目级配置通常会覆盖用户级配置。
密钥管理
不同人员和应用建议使用独立 Key,并设置额度、速率和来源限制。配置文件中含有 Key 时,不要提交到代码仓库;密钥不再使用或怀疑泄露时,及时在控制台禁用并重新创建。