本页将青云 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。 - 先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。
n8n：本地图片生成视频工作流（融合自原文档）
n8n 工作流获取本地图片生成视频例子
一、首先第一个节点选择触发方式，第二个节点选择从本地磁盘获取文件，第三个节点选择请求数据接口生成视频，第四个节点查询生成的视频
二、点进去读取文件
1.选择第一个从本地获取图片；
2.第二个是文件地址需要注意文件地址斜杠""从磁盘复制出来的需要换成： "/" ；
三、点进第一个请求里
method 根据需要用到的接口的请求方法来，url是接口请求地址（veo模型的接口地址为 https://top.qingyuntop.ai/v1/videos ，其他模型请查看左侧代码），验证的类型选 选择第二个，
权限选Bearer Auth
新增 在里面填令牌，可以在全部的http请求使用这个权限
如果上面那个权限不行，就在Send Headers打开 在里面 Name输入：Authorization，
在Value输入：Bearer+令牌(Bearer和令牌中间有一个空格)
2.在打开send Body根据文档输出相应的参数传参类型选择Form Data
3.传图片这个位置比较特殊，左边是我们在上一个节点获取的本地的图片,
在传图片是选择n8n Binary File 能够获取左边的内容，value 里面填入data就是左边整个图片
四、打开第四个节点
1.其他的配置都跟上面一样，但是因为是查询接口那么要看id在那个位置，如果https://xxxx:xxxx/xxxx/{id} 这种格式id在接口的最后的，就需要把左边上一个节点接口获取的id放入这个位置，可以手动输入，也可以点击左边我红圈位置的Tid标识符，拖拽到接口最后的位置，呈现如图所示
接入检查
- API Key 使用
$QINGYUN_TOP_API_KEY占位符保存，不要直接粘贴到公开代码或截图。 - OpenAI 兼容客户端通常使用
https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写/v1。 - 先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。
n8n 配置（融合自原文档）
n8n官方网站：https://n8n.io/
github网址：https://github.com/n8n-io/n8n
安装可以请参考官方文档或者B站教程
以下为调用TOP API配置教程
1、进入n8n界面，在overview中，点击credential，点击下方“Add first credential”
2、在弹出的窗口中搜索openai，并点击红色“continue”确认
3、在弹出的界面中，按照下方的红色箭头设置您的API，并保存
Base Url 地址：https://top.qingyuntop.ai/v1
填完后，点击右上方的红色按钮“save”保存。
然后会显示“Connection tested successfully ”即连接成功
4、在agent中调用，安寨下方的步骤选择openai
5、在弹出的界面中选择刚刚建好的“openai”账户，下方选择需要的模型，然后点击save。
这样每次添加ai Agent都可以调用已经设置好的青云API了。
注：具体使用请查看相关B站教程
接入检查
- API Key 使用
$QINGYUN_TOP_API_KEY占位符保存，不要直接粘贴到公开代码或截图。 - OpenAI 兼容客户端通常使用
https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写/v1。 - 先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。
统一接入检查与故障排查
- 401/403：确认 API Key 未过期、令牌分组允许目标模型，且没有把示例占位符原样提交。
- 404：核对应用要求的 Base URL 形式；
https://top.qingyuntop.ai/dashboard/、https://top.qingyuntop.ai/v1和完整路径不能重复拼接。 - 模型为空或不可用：调用
GET /v1/models，复制返回的完整模型 ID，并确认应用使用的协议（OpenAI Chat Completions、Responses 或 Anthropic Messages）。 - 切换 Provider 后仍访问旧地址：完全退出并重启客户端，检查环境变量、代理和 CC Switch 路由是否覆盖了新配置。
- 生产环境安全：不要把真实密钥放进前端代码、截图、公开仓库、Deep Link 或工作流导出文件；先用低额度测试令牌验证。
> 本页保留每个来源教程的具体字段、命令、截图和高级选项；重复的 API Key、Base URL 和验证说明已统一到本页开头与本节。
发布前检查
以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。
- 模型 ID：先用目标 API Key 请求
GET https://top.qingyuntop.ai/v1/models，把返回的data[].id原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。 - 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从
output读取，Chat 的返回从choices[].message读取。 - Base URL：通常填写
https://top.qingyuntop.ai/v1，也就是只保留一个/v1。要求完整接口地址的客户端才追加/responses或/chat/completions，不要重复追加。 - 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
- 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录
request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。