Gemini 2.5 Flash Image 参数 - YingTu API Docs

提示词和来源图片放入 contents[].parts[]，图片输出控制放入 generationConfig。这个模型最常见的参数错误，是把约 1K 输出误写成 imageSize: "1K"。

字段	当前规则
模型 ID	`gemini-2.5-flash-image`
`responseModalities`	至少包含 `IMAGE`；需要文字说明时同时加入 `TEXT`
`candidateCount`	省略或设为 `1`；当前接口只支持单图输出
`imageConfig.aspectRatio`	可选；见下方十种值
`imageConfig.imageSize`	必须省略
图片输入	`inlineData.mimeType` 与纯 Base64 `data`，两者都必填

支持的宽高比

1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。

文生图请求

{
  "contents": [{
    "role": "user",
    "parts": [{"text": "雨后老街上的暖色书店，横版纪实摄影"}]
  }],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {"aspectRatio": "16:9"}
  }
}

图片编辑请求

把编辑要求和来源图片放在同一个 parts 数组。data 不能包含 data:image/png;base64, 前缀。

{
  "contents": [{
    "role": "user",
    "parts": [
      {"text": "保留主体，把背景改成清晨海边"},
      {"inlineData": {"mimeType": "image/png", "data": "BASE64_SOURCE_IMAGE_1"}},
      {"inlineData": {"mimeType": "image/jpeg", "data": "BASE64_SOURCE_IMAGE_2"}}
    ]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {"aspectRatio": "1:1"}
  }
}

不要发送顶层 prompt、n、resolution，也不要补传 imageSize。响应可能同时包含文字和图片，不能固定读取 parts[0]。

同步请求可重复加入 inlineData。统一异步编辑接收 1～16 张 PNG、JPEG 或 WebP，每张解码后不超过 20 MiB，合计不超过 64 MiB；mimeType 必须与真实字节一致。可运行调用、异步提交和解码方式见示例页。

最后修改于 2026年9月3日