本页将青云 TOP API 客户端接入资料按使用场景合并整理，适合第一次接入的用户，也适合需要核对协议和路径的 API 开发者。青云 TOP API 基于 New API 部署，因此 New API 官方应用教程中的兼容配置可以直接复用。

快速判断：我应该看哪一段？

  • 只想聊天：先看桌面端的基础配置。
  • 要接入 MCP、知识库或工作流：看 Agent/自动化章节。
  • 要在终端写代码：看 CLI、Provider 和环境变量章节。
  • 遇到 401、403、404 或模型不兼容：先检查本文末尾的接入检查清单，再查看对应来源章节。

n8n 工作流使用中转 API（融合自原文档）

1.创建一个新的工作流

2.选择合适的触发方式,我选择的是第一个,手动触发

3.添加下一个工作流模块

4.选择openai

5.聊天必须选择 message a model

6.开始配置 中转API

APIKEY在 API令牌页面生成获取
Base URL 填写 我们中转地址 https://top.qingyuntop.ai/v1 改成 https://top.qingyuntop.ai/v1

点击 save 保存

7.点击保存后提示如下,代表链接成功

8.我简单的配置一下这个模块

我点击 Execute step 进行测试运行

完美响应

接入检查

  • API Key 使用 $QINGYUN_TOP_API_KEY 占位符保存，不要直接粘贴到公开代码或截图。
  • OpenAI 兼容客户端通常使用 https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写 /v1。
  • 先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。