本页参考 New API 官方 AI 应用文档，已按青云 TOP API（New API 兼容）环境整理。API 地址使用 https://top.qingyuntop.ai/v1，API Key 使用 $QINGYUN_TOP_API_KEY 占位符，请在青云 TOP API 控制台创建并妥善保存密钥。

DeepChat 教程 — 将全功能AI Agent客户端对接 青云 TOP API，并通过 DeepLink 一键导入 DeepChat 配置。

聊天设置选项

在 青云 TOP API 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 DeepChat：

{ "DeepChat": "deepchat://provider/install?v=1&data={deepchatConfig}" }

DeepChat 是一款开源、跨平台的商业化友好全功能AI Agent客户端，支持云端与本地模型、MCP 工具调用、Skills、ACP、Agent 集成和远程控制等工作流，适合需要统一管理多个 Provider 与高级 AI Agent的用户。

青云 TOP API 接入方法

方式一：一键导入

  1. 在 青云 TOP API 控制台侧边栏进入「令牌管理」，找到需要使用的令牌

!进入令牌管理

  1. 在令牌操作中选择 DeepChat

!选择 DeepChat

  1. 浏览器唤起 DeepChat，确认打开应用 !打开 DeepChat
  1. 在 DeepChat 的 Provider 导入预览中确认配置 !确认 DeepChat 配置
  1. 打开模型列表，选择 青云 TOP API 模型开始使用 !打开模型列表

方式二：手动导入

  1. 在 青云 TOP API 控制台复制 API Key 和站点地址 !青云 TOP API 手动配置指引
  1. 在 DeepChat 设置中添加或编辑 青云 TOP API Provider，填写 API 地址和 API Key !DeepChat 手动配置指引
  1. 打开模型列表，选择 青云 TOP API 模型开始使用 !打开模型列表

相关链接

接入检查

  • API 地址填写青云 TOP API 的 Base URL：https://top.qingyuntop.ai/v1；应用若要求不带 /v1 的站点地址，请按页面说明填写对应格式。
  • API Key 只使用环境变量 $QINGYUN_TOP_API_KEY 或应用的安全密钥存储，不要把真实密钥提交到代码仓库。
  • 模型名称必须与控制台可用模型完全一致；遇到 401/403 检查密钥、分组和模型权限，遇到 404 检查 Base URL 是否重复填写 /v1。

发布前检查

以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。

  1. 模型 ID：先用目标 API Key 请求 GET https://top.qingyuntop.ai/v1/models，把返回的 data[].id 原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。
  2. 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从 output 读取，Chat 的返回从 choices[].message 读取。
  3. Base URL：通常填写 https://top.qingyuntop.ai/v1，也就是只保留一个 /v1。要求完整接口地址的客户端才追加 /responses 或 /chat/completions，不要重复追加。
  4. 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
  5. 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录 request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。