本页将青云 TOP API 客户端接入资料按使用场景合并整理，适合第一次接入的用户，也适合需要核对协议和路径的 API 开发者。青云 TOP API 基于 New API 部署，因此 New API 官方应用教程中的兼容配置可以直接复用。
其他开源应用调用，先准备三项配置
- 在控制台创建一个专用 API Key，并用客户端安全存储保存。
- 使用青云 TOP API 的 Base URL：
https://top.qingyuntop.ai/v1。应用若要求站点根地址或完整/v1地址，请以该应用字段提示为准，不要重复添加/v1。 - 从
GET /v1/models或型列表复制准确模型 ID；模型名称、协议和令牌分组必须匹配。
快速判断：我应该看哪一段？
- 只想聊天：先看桌面端的基础配置。
- 要接入 MCP、知识库或工作流：看 Agent/自动化章节。
- 要在终端写代码：看 CLI、Provider 和环境变量章节。
一，第三方客户端接入
第三方客户端的界面不同，但配置逻辑相同：创建专用令牌，选择兼容协议，填写 青云TOP API 地址，再选择当前令牌可见的模型。常用桌面客户端及浏览器，更多请查看左侧目录。
| 常用工具 | 点击查看部署配置教程 |
|---|---|
| CherryStudio-支持对话/生图/知识库 | 点击查看CherryStudio基本配置教程 |
| ChatBox-支持基本的对话生图（包含手机端和电脑端） | 点击查看ChatBox配置教程 |
| Omate-角色对话（手机端） | 点击查看Omate配置教程 |
| 酒馆-角色对话 | SillyTavern（酒馆）配置 |
| 沉浸式翻译-全能翻译工具 | 点击查看沉浸式翻译配置教程 |