先确认本站是否开放

青云TOP API 的模型可见性受账号分组和令牌模型限制影响。列表出现目标 ID 是接入前的检查步骤,仍需确认该型号的请求格式与账号可用额度。这里的查询不会创建图片。

第一步:设置鉴权

把请求头中的 YOUR_API_KEY 替换为青云TOP API 的 API Key,保留 Bearer 后的空格。不要使用阿里云百炼的 API Key。

第二步:查询模型列表

GET https://top.qingyuntop.ai/v1/models
Authorization: Bearer YOUR_API_KEY

cURL 使用 Bash、cURL 7.76+ 和 jq;Python 需 requests;Node.js 需 20+,保存为 .mjs 运行。示例会覆盖 response.json;60 秒是客户端超时设置。

set -euo pipefail
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X GET "https://top.qingyuntop.ai/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output response.json
jq -r 'if .error or .success == false then error(.message // (.error | tostring))
  elif (.data | type) != "array" then error("模型列表格式异常")
  else [.data[] | .id | select(type == "string") | select(test("qwen.*image|z[-_]image"; "i"))]
    | if length == 0 then "列表未找到千问或 Z-Image 生图型号,请联系本站支持确认。" else .[] end end' response.json

读取查询结果

成功时读取 data 数组内各对象的 id(模型 ID 字符串)。示例保存完整列表,并筛选名字包含 Qwen Image 或 Z-Image 的项目;无匹配不等于查询失败。HTTP 错误、error 或 success=false 应按错误响应处理,不要当成空模型列表。

此接口只列出型号,不返回图片能力表或生成结果。即使找到型号,也不能只凭名称推断支持编辑、多图、流式或厂商原生请求。

当前文档边界

你要做的事适用的官方模型或协议本站状态
Qwen Image 3.0 文生图或编辑qwen-image-3.0-pro、qwen-image-3.0;厂商 OpenAI 兼容或 DashScope尚未从公开模型列表确认,不能当作本站已开放
Qwen Image 2.0 文生图或编辑qwen-image-2.0-pro、qwen-image-2.0 及日期版本尚未从公开模型列表确认,不能当作本站已开放
Z-Image 文生图z-image-turbo;厂商 DashScope 同步接口尚未从公开模型列表确认,不能当作本站已开放
查看可用模型GET /v1/models青云TOP API 公共入口

如果列表中没有目标 ID,请不要用旧页面的模型名反复提交。请联系青云TOP API 支持,并提供目标模型 ID、时间和脱敏错误(如有)。厂商支持某型号不代表本站已经为你的账号配置该型号。

下一步:查看千问生图官方模型与参数说明,了解官方限制;再阅读千问生图协议差异与常见问题,确认 OpenAI 兼容和 DashScope 字段不能混用。