小白用户快速开始指南

青云TOP API 国际站聚合 300+ 全球模型，并提供与 OpenAI 兼容的调用方式。先判断自己的使用场景，再按本文准备 API Key、接口地址和模型名称，即可开始调用。本站在海外独立运行，仅向非中国大陆用户提供海外模型接入服务。

先了解中转站与模型分组

青云TOP API 在你的客户端与模型服务之间提供统一网关。使用青云TOP API Key、模型 ID 和匹配的协议发起请求后，网关会校验权限与额度，选择可用渠道，完成请求和响应适配，并记录用量与费用。你无需填写模型厂商的账号凭据。

分组决定密钥可使用的模型服务及计费范围。同名模型在不同分组中的价格和能力可能不同；auto 按站点当前配置的分组顺序寻找可用渠道，不代表自动选择最低价格。首次使用先确认模型与分组可用，再用小额度密钥验证。

先按你的目标选入口

一、在线调用：不安装软件也能验证

登录控制台后打开操练场：https://top.qingyuntop.ai/dashboard//console/playground。选择分组和模型即可进行对话调试。在线工具仅用于测试，请及时将重要提示词、对话和结果保存到本地。

二、开源软件调用：填三项通用配置

大多数兼容 OpenAI 格式的应用都只需要填写 API 类型、接口地址、API Key 和模型名称。具体字段名称可能叫 Base URL、Endpoint、代理地址或密钥地址。

三、通用配置：接口地址、密钥、模型

不同软件的字段名称可能不同，但调用链路基本一致。建议按下面顺序填写并逐项测试。

四、代码调用：发出第一个请求

先调用模型列表确认模型 ID，再发送一条最小对话请求。下面示例使用占位符，不包含真实密钥。

curl https://top.qingyuntop.ai/v1/chat/completions \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "你好"}]
  }'

分组怎么选？

先在控制台确认目标模型支持的分组和实时价格。日常体验用最小请求验证；编程代理、工具调用或生产业务还应逐项验证实际需要的能力。同一模型换分组后，价格、速度和参数支持可能变化。auto 按当前配置顺序路由，不保证最低价，也不能修复协议不匹配。详细操作见上方“模型分组、渠道与 auto 路由说明”。

遇到问题先看这里