中转站解决什么问题？

不同模型厂商的地址、鉴权、请求格式和返回结构并不完全相同。青云TOP API 在客户端与模型服务之间提供统一网关，负责验证你的 API Key，并根据密钥设置、模型权限和当前可用服务选择调用渠道。

对用户来说，它主要解决四件事：

能力对用户的作用
统一入口客户端和代码使用青云TOP API 的地址和 API Key，不必分别维护多个厂商账号
模型聚合在一个模型列表中查看当前开放的文本、图像、音频或视频模型
协议适配按页面说明使用 OpenAI 兼容、Responses 或模型原生协议
用量结算在青云TOP 控制台查看调用记录、用量和费用

中转站不是把某个厂商的官方文档换一个域名。模型能否调用、支持哪些参数以及如何计费，还会受到站点当前模型配置、分组、渠道和协议适配的影响。

一次调用会经过哪些步骤？

  1. 客户端或代码向 https://top.qingyuntop.ai/v1 对应接口发送请求，并携带青云TOP API Key。
  2. 网关检查 API Key 是否启用，以及余额、密钥额度、分组、模型限制和请求频率是否符合要求。
  3. 网关从请求路径和请求体识别协议入口及 model。
  4. 系统在当前分组中寻找同时支持该模型与协议的可用渠道。
  5. 系统按照当前渠道配置完成选择；必要时按配置尝试其他可用渠道。
  6. 渠道适配器处理服务地址、鉴权、模型名称映射以及请求和响应格式。
  7. 网关向客户端返回结果，并记录模型、用量、费用、状态和请求时间等信息。

你可以在使用日志中核对最后一步。客户端只显示“连接成功”时，还要实际发送一次最小请求并收到回复，才能确认整个链路可用。

常见渠道如何理解？

渠道类型一般特点使用时要注意
厂商官方 API使用模型厂商公开提供的 API仍可能经过模型名称映射、计费和响应适配
Azure、Bedrock、Vertex 等云服务由云平台托管官方模型模型版本、区域、字段和额度可能与模型厂商官网不同
第三方兼容渠道通过兼容协议提供模型服务“OpenAI 兼容”只描述接口格式，不代表 OpenAI 官方渠道
非官方兼容渠道以尽力兼容方式提供能力功能和稳定性可能变化，应逐项测试，不用于要求明确服务等级的场景
站点扩展能力图片、视频、音乐或异步任务等聚合接口以本站文档和实际测试为准，不能直接套用厂商原文

普通用户不需要手动选择具体服务节点。你需要选择的是账户开放的分组和模型；系统再在该分组内寻找可用渠道。

“协议兼容”不等于“能力完全一样”

同一个协议入口可以服务多个模型，但不表示所有模型都支持相同能力。使用前至少核对以下项目：

  • 协议和路径： 确认使用 Chat Completions、Responses、Anthropic Messages、Gemini 原生协议或其他专用接口。
  • 输入类型： 文本模型不一定能接收图片、音频或文件。
  • 高级能力： 工具调用、结构化输出、联网搜索和提示词缓存需要模型与渠道共同支持。
  • 参数范围： 某些模型会忽略或拒绝温度、输出长度等参数。
  • 上下文限制： 同名模型在不同渠道的上下文或最大输出能力可能不同。
  • 返回细节： 渠道切换后，错误信息、用量字段和完成原因可能存在差异。

因此，不要只根据模型名称推断能力。先阅读模型说明，再用准备投入使用的 API Key、分组和协议完成真实测试。

开始调用前准备四项信息

  1. 在控制台创建一把用途明确、额度合理的API Key。
  2. 从模型列表复制当前可用的完整模型 ID。
  3. 确认模型所在分组及其价格。
  4. 按模型说明选择协议、接口路径和正确的请求 JSON。

不要填写或向他人提供模型厂商 API Key、Cookie、账号密码、短信验证码或内部服务地址。青云TOP API Key 也应只保存在可信客户端或服务端环境变量中，不要出现在公开代码、截图和聊天记录里。

如何确认调用成功？

  1. 使用短文本和默认参数发送最小请求。
  2. 确认返回 HTTP 成功状态，并检查正文、完成状态和业务需要的字段。
  3. 在控制台日志中找到同一时间、密钥和模型的成功记录。
  4. 核对实际用量和费用，再逐个开启图片、工具、流式等能力。

如果失败，保存状态码、请求 ID、时间、模型、分组和已脱敏错误信息，再按调用常见问题排查。不要通过连续重复请求来碰运气。

下一步：模型分组、渠道与 auto 路由说明。