POST/v1beta/models/gemini-2.0-flash-exp-image-generation:generateContent

Gemini Image 图片编辑与多图参考

读取本地图片，将它们编码后与修改指令一起提交，实现背景修改、风格参考和多图合成。生成与编辑共用 generateContent 接口。

API Key application/json

功能与支持模型

推荐 gemini-3.1-flash-image 或 gemini-3-pro-image。二者最多结合 14 张参考图片；示例使用两张图片和 Flash 的 2K 输出。Lite 适合简单编辑，需改用 1K；旧版 2.5 建议最多 3 张输入并省略 imageSize。

准备真实的 product.png 与 reference.png，放在脚本目录中。第一张表示产品，第二张表示风格参考；图片数组顺序与提示词中的“第一张”“第二张”必须一致。只编辑一张图片时，删除第二张图片块和对应文件处理，同时修改提示词。

第一步：设置鉴权

使用请求头 Authorization: Bearer YOUR_API_KEY。将 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后的空格；基础地址为 https://top.qingyuntop.ai。

第二步：调用模型

POST https://top.qingyuntop.ai/v1beta/models/gemini-3.1-flash-image:generateContent

请求类型为 application/json。上传过程是客户端读取文件、Base64 编码并写入 inlineData，不需要创建文件任务，不使用 multipart/form-data。

Request

请求

/v1beta/models/gemini-2.0-flash-exp-image-generation:generateContent

Body

必填

Bodyobject

contentsarray<object>必填

元素object

partsarray<object>

元素object

textstring

inline_dataobject

mime_typestring必填

datastring必填

generationConfigobject必填

responseModalitiesarray<string>必填

元素string

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`key`	Query	string	是	-	YOUR_API_KEY
`Content-Type`	Header	string	是	-	application/json

请求示例application/json

set -euo pipefail
cat > request-template.json <<'JSON'
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "以第一张图中的产品为主体，参考第二张图的配色和背景风格。保留产品轮廓、标志和文字，生成一张简洁的商品宣传图。"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "__IMAGE_1__"
          }
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "__IMAGE_2__"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}
JSON
base64 < product.png | tr -d '\r\n' > image-1.b64
base64 < reference.png | tr -d '\r\n' > image-2.b64
jq --rawfile image1 image-1.b64 --rawfile image2 image-2.b64 '.contents[0].parts[1].inlineData.data = ("" + $image1) | .contents[0].parts[2].inlineData.data = ("" + $image2)' request-template.json > request.json
[ "$(wc -c < request.json)" -lt 20000000 ] || { echo "请求超过 20 MB，请压缩图片或缩短历史" >&2; exit 1; }
curl --fail-with-body --connect-timeout 30 --max-time 600 "https://top.qingyuntop.ai/v1beta/models/gemini-3.1-flash-image:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  --output response.json

Response

返回响应 `200`

HTTP 响应

响应 200object

返回结果与连续修改

Python/Node.js 自动解码保存非思考图片，完整响应保存在 response.json；cURL 的结果解码见图片保存。输入与输出的格式可能不同，以返回 mimeType 选择扩展名。

需要保持设计上下文时，采用多轮编辑与思考签名。不要只截取上一轮 Base64 后冒充完整的 model 历史；若要发起独立编辑，可将已生成图片作为新的 user 图片输入。

常见错误与参考

Base64 错误通常来自 data URI 前缀、字符串截断、MIME 不匹配或复制了带省略号的样例。413 或请求过大时，先缩小图片、减少参考图或历史，不反复提交相同大包。官方参考：图片编辑指南、图片输入限制。