本页整理自 Apifox 原客户端接入资料，按青云TOP API 文档规范补充了安全占位符、Base URL 和验证步骤。

ChatGPT开源桌面应用，支持全部桌面平台。
下载链接：https://chatboxai.app/zh
ChatBox的网页版本地址：https://web.chatboxai.app

电脑端配置方法：

1、打开配置-> 选中“添加”

ChatBox（手机端和电脑端） 配置步骤图 1

2、在弹出窗口中，添加API名称，选择openai兼容，然后点击添加

ChatBox（手机端和电脑端） 配置步骤图 2

3、按下图填写

ChatBox（手机端和电脑端） 配置步骤图 3

填写apikey 和 接口地址 https://top.qingyuntop.ai/v1
模型名称请查看模型列表：https://top.qingyuntop.ai/dashboard//pricing
4、配置完后，您可以直接在聊天界面，选择青云API中的模型，与之对话了。

ChatBox（手机端和电脑端） 配置步骤图 4

手机端配置方法：

1、安装并打开chatbox，按下图点击，打开设置-模型提供方-添加：

ChatBox（手机端和电脑端） 配置步骤图 5

2、设置名称，并选中openai兼容

ChatBox（手机端和电脑端） 配置步骤图 6

3、按下图配置API
接口地址为：https://top.qingyuntop.ai/v1

ChatBox（手机端和电脑端） 配置步骤图 7

4、配置完后，您可以直接在聊天界面，选择青云API中的模型，与之对话了。

ChatBox（手机端和电脑端） 配置步骤图 8

需要注意，使用gpt模型时，要将Top P关闭（点击×号），如下图操作

ChatBox（手机端和电脑端） 配置步骤图 9
ChatBox（手机端和电脑端） 配置步骤图 10

接入检查

  • API Key 使用 $QINGYUN_TOP_API_KEY 占位符保存，不要直接粘贴到公开代码或截图。
  • OpenAI 兼容客户端通常使用 https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写 /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 判定成功。