先确认调用方式
使用 POST https://top.qingyuntop.ai/v1/images/generations、Authorization: Bearer YOUR_API_KEY、Content-Type: application/json，将模型写为 grok-imagine-image-2.0。先用 文生图 的单张示例确认接入。
HTTP 错误
以下是常见排查方向，具体原因以响应正文中的错误信息为准；状态码不能独立判断上游执行情况。
| 现象 | 建议处理 |
|---|---|
| 400 / 参数无效 | 检查 JSON、模型、非空 prompt；n 必须为 1–10 的整数；response_format 只填 url 或 b64_json。先移除本目录未推荐的字段。 |
| 401 / 鉴权失败 | 使用本站 API Key；保留 Bearer 后的空格；检查 Key 是否有效，不使用厂商控制台的密钥。 |
| 403 / 无权调用 | 检查 API Key 的模型范围、账号权限及响应正文，必要时联系本站支持。 |
| 404 / 模型或路由不可用 | 检查完整路径和准确模型 ID；目录或价格页出现型号不代表当前 Key 一定可用。 |
| 429 / 额度或频率限制 | 结合正文区分额度、限流或当前容量；若有 Retry-After 则遵循，避免并发重试风暴。 |
| 5xx / 上游异常 | 保存脱敏错误与调用时间，稍后评估是否重试；不要对可能已执行的生成无限重放。 |
返回 200，但没有可用图片
检查顶层 error、data 是否非空、每个元素是否包含所请求的 url 或 b64_json。不要把空数组、文字错误信息或 HTML 页面当成生成成功。
若提示词触发内容限制，调整不合适的内容后再提交；不要以反复重试绕过限制。返回数量不足时保存已得到的图片并检查完整响应，不能默认为其余图片仍在后台等待查询。
设置尺寸或编辑参数没有生效
本目录通用方式只推荐 model、prompt、n、response_format。size、quality、resolution、aspect_ratio、参考图和遮罩不在本页调用保证范围内。需要精确尺寸或图片编辑，请先联系本站支持确认相应接口；不要仅修改端点为 /images/edits 就假定可以编辑。
下载失败、文件打不开或请求超时
URL 模式收到结果后及时下载，下载请求不发送本站 API Key。检查 HTTP 状态、文件字节以及 MIME；不要将 Base64 字符串直接写成 PNG，也不要给所有结果固定加 .jpg。可直接使用 图片保存示例。
600 秒示例超时是客户端设置。超时、断线或关闭应用都不等于服务端取消，重试生成可能产生新的请求与费用。先核对控制台记录，必要时联系支持；本流程没有可推荐的任务轮询或取消入口。
旧型号如何处理
新接入使用 grok-imagine-image-2.0。厂商已于 2026-05-15 停用 grok-imagine-image-pro，并宣布 grok-imagine-image-quality 将于 2026-11-02 停用；grok-imagine-image 不在这次 quality 停用公告范围内。旧项目应核对本站当前可用型号，不依赖厂商自动重定向会在本站原样生效。本目录不提供已停用型号的调用教程。
联系支持与参考
请提供模型 ID、调用时间及时区、HTTP 状态、脱敏错误正文，以及响应头中可获得的请求标识。移除 API Key、图片 Base64、签名 URL 和业务隐私；本流程没有返回任务 ID 时无需编造 ID。
厂商参考：Image 2.0 模型、Pro 停用公告、Quality 停用公告。本站费用以 控制台 为准。