外接兼容总览

很多第三方客户端、自建工具和服务端程序，只要支持 OpenAI 兼容协议，就可以接到云桥AI。

这类接入通常不是重新开发一套逻辑，而是替换两个关键值：

• Base URL
• API Key

先判断你的工具属于哪一类

1. 第三方客户端

例如桌面端、IDE 插件、聊天客户端或聚合工具。它们通常提供：

• Base URL 输入框
• API Key 输入框
• 模型名称输入框

这类场景优先看 第三方客户端接入。

2. 服务端程序

例如 Node.js、Python、Java、Go 后端，或你自己的中间层服务。它们通常通过 SDK 或 HTTP 请求接入。

这类场景优先看 服务端程序接入。

外接接入的最小条件

无论你用什么工具，至少要确认这三项：

• 地址填的是 https://yunqiaoai.com.cn/v1
• 请求头能带上 Authorization: Bearer <API Key>
• 模型名称使用平台当前支持的可用模型

最常见的接入失败原因

• 把主站首页地址当成了 API 地址
• 只登录了网页，但没有创建 API Key
• 第三方工具写死了自己的默认供应商设置
• 请求格式虽然兼容，但模型名或参数组合不兼容

如果接入失败，不要先怀疑平台，先检查：地址、Key、模型名、请求方式这四件事。