本页整理自 Apifox 原客户端接入资料，按青云TOP API 文档规范补充了安全占位符、Base URL 和验证步骤。
1.下载安装zed
打开官网根据需要的版本下载并安装：https://zed.dev/download
2.打开设置
3.配置API
在提供商中填写：
name：可以随便写
APIURL：https://top.qingyuntop.ai/v1
APIkey：在账户中获取并填入其中， 通常以sk-开头
model name：填写正确的模型名称，如claude-opus-4-5-20251101，
根据需要您可以填写多个模型。模型在不断更新变化，请在模型列表中查看最新模型 https://top.qingyuntop.ai/dashboard//pricing
其他根据需要填写。配置完成后点击下方的保存。
4.选择模型
在对话中选择模型，就可以对话了
接入检查
- API Key 使用
$QINGYUN_TOP_API_KEY占位符保存，不要直接粘贴到公开代码或截图。 - OpenAI 兼容客户端通常使用
https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写/v1。 - 先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。
发布前检查
以下检查适用于客户端中选择 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 判定成功。