在控制台选择模型

  1. 打开模型广场或模型定价，按文本、图像、音频等用途筛选。
  2. 查看完整模型名称、支持的端点和计费方式；选择密钥对应分组（若提供分组筛选）。
  3. 复制模型 ID，而不是宣传名称或自己起的别名。
  4. 用实际准备使用的密钥发送一个最小请求，验证能力和权限。

开发者查询模型列表

先把 QINGYUN_TOP_API_KEY 配置为环境变量。下面命令适用于 Bash；Windows 用户可以使用 WSL，或参考HTTP 示例中的 PowerShell 写法。

curl --fail-with-body --connect-timeout 10 --max-time 30 \
  'https://top.qingyuntop.ai/v1/models' \
  -H "Authorization: Bearer $QINGYUN_TOP_API_KEY"

OpenAI 格式列表通常从 data[].id 读取名称。列表查询成功并不保证模型支持图片、工具调用、JSON 输出或所有协议，这些仍需查模型说明并实测。

选择时别只比较名称

检查项为什么要看
支持协议决定使用 Chat、Responses 或原生格式
输入输出类型文本模型不一定接受图片或音频
上下文与输出限制超长请求可能被拒绝或截断
价格与计费单位输入、输出、缓存或按次可能分别计费
账户与分组权限决定当前密钥是否有可用路由

模型名不对时不要靠不断换名字试错。先重新复制完整 ID，再看模型定价与兼容性。