功能与支持模型
| 官方模型 ID | 适用场景与输出范围 |
|---|---|
gemini-3.1-flash-image | Flash Image / Nano Banana 2。日常生图、海报、多图一致性与快速迭代。默认推荐。 imageSize：512 / 1K / 2K / 4K。 14 种比例；最多 14 张参考。 |
gemini-3-pro-image | Pro Image / Nano Banana Pro。复杂构图、精细文字、品牌素材和专业设计。思考默认开启，不能设置思考等级。 imageSize：1K / 2K / 4K。 10 种比例；最多 14 张参考。 |
gemini-3.1-flash-lite-image | Flash Lite Image / Nano Banana 2 Lite。轻量生图、简单改色与背景调整。建议少量参考；复杂多图与连续编辑优先选 Flash 或 Pro。 imageSize：1K。 本目录推荐 10 种常用比例。 |
gemini-2.5-flash-image | 旧版 Flash Image / Nano Banana。旧项目迁移参考；建议最多 3 张输入。不设置 imageSize。官方停用日期为 2026-10-02，本次核对日期已到，应迁移至 3.1 Flash Image。 输出约 1K，具体像素随比例变化。 |
本站当前可见型号（2026-10-02）
下面是青云TOP API 公共目录快照，不等同于厂商官方型号清单。带-c、-preview、-t或尺寸后缀的名称按本站模型 ID 使用；是否可调用仍以你的 API Key 的GET /v1/models结果为准。
| 模型 ID | 可见协议 | 分组 |
|---|---|---|
gemini-2.5-flash-image | gemini、openai | Verterx渠道Gemini、Gemini官转、Gemini特价 |
gemini-2.5-flash-image-preview | gemini、openai | Gemini官转 |
gemini-3-pro-image | gemini、openai | Verterx渠道Gemini、Gemini官转 |
gemini-3-pro-image-c | gemini、openai | 按次计费 |
gemini-3-pro-image-preview | gemini、openai | Verterx渠道Gemini、Gemini官转 |
gemini-3-pro-image-preview-2k | gemini、openai | Gemini官转 |
gemini-3-pro-image-preview-4k | gemini、openai | Gemini官转 |
gemini-3-pro-image-preview-c | gemini、openai | 按次计费 |
gemini-3-pro-image-preview-t | gemini、openai | Verterx渠道Gemini |
gemini-3.1-flash-image | gemini、openai | Verterx渠道Gemini、Gemini官转、Gemini-CLI、Gemini特价 |
gemini-3.1-flash-image-c | gemini、openai | 按次计费 |
gemini-3.1-flash-image-preview | gemini、openai | Verterx渠道Gemini、Gemini官转 |
gemini-3.1-flash-image-preview-2k | gemini、openai | Gemini官转 |
gemini-3.1-flash-image-preview-4k | gemini、openai | Gemini官转 |
gemini-3.1-flash-image-preview-c | gemini、openai | 按次计费 |
gemini-3.1-flash-lite-image | gemini、openai | Verterx渠道Gemini、Gemini官转、Gemini特价 |
常用比例为 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。3.1 Flash Image 额外支持 1:4、4:1、1:8、8:1。Pro 与 Lite 请使用常用比例。
Flash/Pro 最多可结合 14 张参考图片，但相似度和细节保留不等于像素级复制。Flash 适合最多 10 个物体及 4 个角色的参考组合；Pro 适合复杂设计。Lite 的主要用途是轻量生成与简单编辑，复杂参考组合优先用 Flash/Pro。旧版 2.5 建议最多 3 张输入，不把它的配置照搬成 4K。
第一步：设置鉴权
使用请求头 Authorization: Bearer YOUR_API_KEY。将 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后的空格；基础地址为 https://top.qingyuntop.ai。
第二步：调用模型
POST https://top.qingyuntop.ai/v1beta/models/{model}:generateContent
请求类型为 application/json。将路径中的 {model} 替换为模型表中的准确 ID。流式使用 :streamGenerateContent?alt=sse，不添加请求体 stream 字段。Chat 参数位置不同，见兼容格式。
请求结构与素材参数
| 字段与类型 | 位置、填写规则与限制 |
|---|---|
model；string | 必填；URL 路径。填写完整模型 ID，见模型表；请求体不再重复写 model。无默认值。 |
contents；object[] | 必填；JSON 顶层数组，至少一轮。单轮传 user；多轮依次传完整历史和新的 user 内容。 |
contents[].role；string | 单轮可省略，本目录显式填写 user；多轮需区分 user 与 model，不能使用 assistant。 |
contents[].parts；object[] | 必填；每轮至少一个内容块，按数组顺序解释。文本与图片放在独立 part 中，不在一个 part 同时填写 text 与 inlineData。 |
contents[].parts[].text；string | 文生图必填、编辑时填写修改指令；无默认值。描述主体、构图、需要保留的元素及文字内容。 |
contents[].parts[].inlineData；object | 编辑/参考图时条件必填；每张图片一个对象，含 mimeType 和 data。文生图省略。不是 multipart 文件字段。 |
contents[].parts[].inlineData.mimeType；string | 与实际文件一致，支持 image/png、image/jpeg、image/webp、image/heic、image/heif；无默认值。推荐 PNG/JPEG。 |
contents[].parts[].inlineData.data；string | 图片原始字节的标准 Base64 字符串；不得加 data: 前缀，不填本地路径或 HTTP URL。完整编码后 JSON 请求保持在 20 MB 以下。 |
contents[].parts[].thoughtSignature；string | 仅在回传 model 历史且响应包含此字段时原样保留；无默认值。不能自行编写、重新编码或移到其他 part。 |
完整编码后的请求控制在 20 MB 以下，包含全部提示、历史与 Base64 数据；Base64 通常比原始文件增加约三分之一体积。这个限制不是“每张图片 20 MB”。本目录使用直接内联图片，不把上游 Files API 的文件 ID、Google Key 或文件地址当作本站共享文件。
生成配置
| 字段与类型 | 位置、填写规则与限制 |
|---|---|
generationConfig；object | 可选；JSON 顶层对象。下面的 responseModalities、imageConfig、thinkingConfig 都嵌套在这里；本目录显式设置图像输出。 |
generationConfig.responseModalities；string[] | 可选；推荐 ["TEXT", "IMAGE"]；只需图片可用 ["IMAGE"]。不要仅填 TEXT。省略时由模型决定输出模态；并不保证一定产生图片。 |
generationConfig.imageConfig；object | 可选；图像配置对象。本站本入口使用此字段，不把 responseFormat.image 或顶层 image_size 混入请求。 |
generationConfig.imageConfig.aspectRatio；string | 可选；字符串。省略时参考输入比例，否则通常为 1:1。通用 10 种与 Flash 扩展 4 种见模型表；不填写像素宽高。 |
generationConfig.imageConfig.imageSize；string | 可选；3.x 默认 1K。Pro：1K/2K/4K；Flash：512/1K/2K/4K；Lite 使用 1K；2.5 省略。512 是字符串，不带 px 或 K；K 必须大写。 |
generationConfig.thinkingConfig；object | 可选；默认使用模型思考策略。不要用 thinkingBudget=0 关闭 Gemini 3 图片模型的思考。2.5 Flash Image 省略该对象。 |
generationConfig.thinkingConfig.thinkingLevel；string | 仅 3.1 Flash Image 与 Flash Lite Image 可选，填写 minimal 或 high，官方默认 minimal。Pro 不填；minimal 不等于禁用思考。 |
generationConfig.thinkingConfig.includeThoughts；boolean | 可选；true 请求返回思考块，通常省略。展示和保存最终图片时跳过 thought=true；隐藏思考内容不等于不产生思考用量。 |
tools；object[] | 可选；JSON 顶层数组。搜索生图使用 [{"google_search": {}}]；Pro/Flash 支持网页搜索，Flash 可进一步配置 searchTypes.imageSearch；Lite/2.5 不填。 |
不要同时提交两套驼峰/下划线别名。本目录原生 JSON 统一使用驼峰字段；imageConfig 的子字段也是 aspectRatio、imageSize。输入识图的 mediaResolution 与输出图片的 imageSize 用途不同，不能互相替代。
不使用 n、quality、size、mask、background、output_format 等 Images API 字段；生图数量、局部修改或背景要求写入文字指令。没有承诺精确张数、确定性种子或像素级蒙版编辑的参数。
代码示例与结果
可直接运行的三语言示例见文生图、4K 输出、图片编辑与流式调用。响应字段与 Base64 保存规则见返回结果。
常见错误与参考
400 通常应先检查字段层级、图片 MIME、Base64 和型号尺寸组合；只有文字输出时检查模型 ID、responseModalities 与安全反馈。不要通过添加未知参数反复重试；参阅错误排查。官方参考：generateContent 参数、图片生成、图片输入。