/v1/images/generations 和 /v1/images/edits 接口调用 Gemini 图像生成模型。
支持的模型
文生图 /v1/images/generations
基础请求
请求参数
分辨率与计费档位
size 参数支持两种格式:
- 档位格式(推荐):
"1K"、"2K"、"4K" - 数字格式:如
"1024x1024",用于兼容历史写法(仅作为推断档位和宽高比的“提示”,最终像素由上游按栅格表决定)
size 以及 aspect_ratio 自动计算标准分辨率档位(1K / 2K / 4K),并映射到上游 Gemini 的 imageConfig.imageSize:
各宽高比在不同档位下的具体像素栅格(例如 1K/2K/4K 下 16:9、9:16、2:3 等对应的精确分辨率),请参考《Gemini 图像生成》文档中的 “分辨率与宽高比” 小节。
gemini-2.5-flash-image 最高仅支持 1K 分辨率。宽高比设置
两种方式控制图像比例:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
响应结构
Python SDK 示例
参考图编辑 /v1/images/edits
通过上传参考图实现图像编辑、风格迁移等功能。
基础请求
多参考图请求
请求参数
自动分辨率推断
当未指定size 时,系统会自动从基准图推断输出分辨率:
- 读取基准图(
image字段)的实际尺寸 - 按模型最大能力限制输出(如
gemini-2.5-flash-image最大 1024) - 保持原图宽高比
- 自动推断功能仅对
gemini-3-pro-image-preview生效; - 当显式传入
aspect_ratio时,会优先使用该宽高比,并结合size(或基准图尺寸推断的档位)映射到上游的imageConfig.aspectRatio与imageConfig.imageSize。
计费说明
采用混合计费模式:
示例计算(Gemini 3 Pro Image 1K):
错误处理
与原生 API 对比
如需使用 Gemini 原生协议(generateContent),请参阅 Gemini 原生图像 API。
