Skip to main content
本文档介绍如何通过 OpenAI 风格的 /v1/images/generations/v1/images/edits 接口调用 Gemini 图像生成模型。

支持的模型


文生图 /v1/images/generations

基础请求

请求参数

分辨率与计费档位

size 参数支持两种格式:
  1. 档位格式(推荐)"1K""2K""4K"
  2. 数字格式:如 "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:12:33:23:44:34:55:49:1616:921:9

响应结构

Python SDK 示例


参考图编辑 /v1/images/edits

通过上传参考图实现图像编辑、风格迁移等功能。

基础请求

多参考图请求

请求参数

自动分辨率推断

当未指定 size 时,系统会自动从基准图推断输出分辨率:
  • 读取基准图(image 字段)的实际尺寸
  • 按模型最大能力限制输出(如 gemini-2.5-flash-image 最大 1024)
  • 保持原图宽高比
  • 自动推断功能仅对 gemini-3-pro-image-preview 生效;
  • 当显式传入 aspect_ratio 时,会优先使用该宽高比,并结合 size(或基准图尺寸推断的档位)映射到上游的 imageConfig.aspectRatioimageConfig.imageSize

计费说明

采用混合计费模式: 示例计算(Gemini 3 Pro Image 1K):

错误处理


与原生 API 对比

如需使用 Gemini 原生协议(generateContent),请参阅 Gemini 原生图像 API