第三方工具接入

适用角色:开发者 更新日期:2026-08-06

支持自定义 Base URL 的客户端,通常都能通过本平台调用模型。不同工具的字段名称略有差异,但配置内容基本相同:API 地址、API Key、模型调用名和协议类型。

具体工具的逐步操作放在 工具接入指南。本页说明各类工具如何选择地址,以及配置完成后怎样确认请求已正确接入。

准备连接信息

进入控制台的「API Key」页面,创建或选择一把 Key;模型调用名可在「调用指南」中复制。下面以 deepseek-v4-flash 为例;如需使用 kimi-k3,可从调用指南复制对应调用名。

配置项 填写内容
API Key 控制台生成的 sk- 开头密钥
模型调用名 deepseek-v4-flashkimi-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 和工作流
网页翻译 沉浸式翻译 沉浸式翻译

验证连接

配置保存后,用一条短消息进行测试:

请只回复:连接成功

随后检查以下几项:

  1. 客户端收到正常回复,没有 401、403 或 404;
  2. 控制台「使用记录」出现一条新记录;
  3. 记录中的 Key、模型和分组与配置一致;
  4. Agent 类工具再执行一次简单工具调用,确认文件读写或命令执行能力正常。

聊天能正常回复,但 Agent 无法调用工具时,通常不是连接问题。可以检查模型是否支持工具调用,以及客户端是否启用了对应能力。

常见问题

返回 401

重新复制 API Key,确认输入框中没有空格、换行或重复的 Bearer 前缀。大多数 API Key 输入框只填写 sk-xxx

返回 403

检查 Key 是否启用、是否过期、是否绑定了可用分组,以及当前用户是否获得该分组。余额或额度不足也可能返回 403,具体以响应中的 code 为准。

返回 404

先看客户端最终请求地址。常见原因是客户端未按协议拼接路径,或者把完整接口地址填进了只接受 Base URL 的字段。

返回 Model Not Found

从控制台「调用指南」重新复制模型名。展示名称和调用名可能不同,配置时应使用调用名。

配置后仍请求原来的服务

完全退出并重启客户端,再检查系统环境变量、用户配置和项目配置。项目级配置通常会覆盖用户级配置。

密钥管理

不同人员和应用建议使用独立 Key,并设置额度、速率和来源限制。配置文件中含有 Key 时,不要提交到代码仓库;密钥不再使用或怀疑泄露时,及时在控制台禁用并重新创建。

更多接口细节见 API 调用基础,错误响应和重试策略见 错误码与排障