接口与鉴权
使用请求头 Authorization: Bearer YOUR_API_KEY。把 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后的空格。
请求方法为 POST，地址为 https://top.qingyuntop.ai/v1/images/generations，请求头还需 Content-Type: application/json。本页参数全部放在 JSON 顶层；完整调用见 文生图。
请求参数
| 字段与类型 | 填写规则、默认值与限制 |
|---|---|
model；string / null | JSON 顶层；必填，显式填写 grok-imagine-image-2.0；不依赖默认型号，不传 null。 |
prompt；string | JSON 顶层；必填非空字符串，无推荐默认值；描述主体、场景、风格、构图与文字要求。 |
n；integer / null | JSON 顶层；可选，不传 null；生成图片数量。一次多张时处理完整 data 数组，以实际返回数量为准。 默认 1。 范围 1–10。 |
response_format；string / null | JSON 顶层；可选，不传 null；允许 url 或 b64_json。url 返回临时图片链接；b64_json 返回不带 data URI 前缀的 Base64。它不指定图片文件编码。 默认 url。 |
可空类型来自接口结构；调用时遵循表内填写规则，直接省略可选字段，不使用 null。显式填写模型与非空提示词，避免依赖默认或容错行为。
参数如何组合
| 需求 | 推荐组合 |
|---|---|
| 快速取得一张图片链接 | model: "grok-imagine-image-2.0"、非空 prompt、n: 1、response_format: "url" |
| 直接在响应中取得图片内容 | 同上，将 response_format 改为 "b64_json" |
| 同一提示词生成多张图片 | n 设为 2–10；遍历返回的整个 data 数组，不只保存第一张 |
Base64 响应体通常比图片原始字节更大，应用需要预留内存和传输空间。URL 模式适合收到结果后立即下载。两者决定返回方式，不决定画质或文件类型。
尺寸、画质与编辑边界
本目录的通用请求只推荐上述四个字段。请勿依赖额外字段一定生效：
size、quality、resolution、aspect_ratio不属于本页推荐参数；不承诺通过这些字段控制输出尺寸、比例或画质。image、images、mask不用于本文文生图流程。需要图片编辑或多图参考时，请先确认本站对应调用说明。storage_options、Files 文件 ID、stream和回调参数不用于本流程；请自行保存返回图片。
可以在提示词中描述构图方向和视觉效果，但这不等于指定精确像素或强制比例。若业务必须得到固定尺寸，应先确认支持该要求的模型接口，或在取得图片后按业务规则处理。
提示词建议
先描述主体与场景，再补充风格、光线、构图和必须出现的文字。避免一次加入互相矛盾的要求；修改提示词后再生成属于一次新的请求。本文不承诺相同提示词重复调用会得到相同图片。
限制与参考
请求断线或客户端超时不表示服务端已停止生成。不要为了获取结果而连续重复提交；先查看控制台用量，必要时联系本站支持。返回处理见 图片保存，排错见 常见错误。厂商参数参考：图片生成指南。