生图模型

gemini-3-pro-image-preview

gemini-generate-content · /v1beta/models/{model}:generateContent

型号与端点

模型 ID：gemini-3-pro-image-preview，请求中使用完整名称。

协议：gemini-generate-content。端点：POST /v1beta/models/gemini-3-pro-image-preview:generateContent。

输入：text、image。输出：image、text。

认证、完整字段和响应格式见 gemini-generate-content。调用前请确认 Key 已开通此型号。

请求示例

json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "白色桌面上的蓝色陶瓷杯，无文字"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 8192,
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

以上为请求体示例，地址和请求头见协议页。其他可选字段请查阅对应参数说明。

参数与输入

文生图和参考图编辑均使用 generateContent，每张参考图放入独立 inlineData 图片 part。响应需遍历全部 parts，分别读取文字和图片。此协议不使用 OpenAI Images 的 size、quality、mask 或 multipart 字段。

附件格式：PNG/JPEG/WebP 参考图。编码：text + 独立 inlineData 图片 parts。

官方限制：参考图数量、尺寸与像素预算依型号；不可套用 GPT Images 上限。

上传说明：参考图分别上传；总张数和总大小按型号确认，实际可用范围还受网关限制。其他限制：不支持函数工具、独立 mask 或通用文件上传。完整规格见模型输入规格表。

响应处理

finishReason 为 STOP 后，跳过 thought:true 的中间内容，读取最终图片 part。只有文字或预览图时，尚未获得最终图片。文件大小及格式要求见文件与媒体输入。