先确认本站是否开放
青云TOP API 的模型可见性受账号分组和令牌模型限制影响。列表出现目标 ID 是接入前的检查步骤,仍需确认该型号的请求格式与账号可用额度。这里的查询不会创建图片。
第一步:设置鉴权
把请求头中的 YOUR_API_KEY 替换为青云TOP API 的 API Key,保留 Bearer 后的空格。不要使用阿里云百炼的 API Key。
第二步:查询模型列表
GET https://top.qingyuntop.ai/v1/models
Authorization: Bearer YOUR_API_KEYcURL 使用 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 字段不能混用。