> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini 3.1 Flash 图片编辑

使用 Gemini 3.1 Flash 模型通过自然语言提示词编辑图片。支持 URL 和 Base64 编码的图片作为输入，最多可传入 14 张参考图。

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="size" type="string" default="1K">
  输出图片的像素尺寸。0.5K（约512px）、1K（约1024px）、2K（约2048px）、4K（约4096px）。默认为 1K

  可选值：`0.5K`, `1K`, `2K`, `4K`
</ParamField>

<ParamField body="google" type="object">
  Google 搜索选项

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      启用 Google 网页搜索，基于真实世界信息生成更准确的图片。
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      启用 Google 图片搜索，使用真实图片作为生成的视觉参考。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  描述期望图片编辑效果的文本提示词
</ParamField>

<ParamField body="image_urls" type="string[]">
  用于编辑的输入图片 URL 列表，最多支持 14 张参考图

  数组长度：0 - 14
</ParamField>

<ParamField body="aspect_ratio" type="string">
  输出图片的宽高比。支持标准比例和新增的超宽/超长比例（1:4、4:1、1:8、8:1）

  可选值：`1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`
</ParamField>

<ParamField body="image_base64s" type="string[]">
  用于编辑的 Base64 编码图片列表。image\_urls 和 image\_base64s 的总数不超过 14 张

  数组长度：0 - 14
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  输出图片的 MIME 类型。支持格式：image/png、image/jpeg。默认为 image/png

  可选值：`image/png`, `image/jpeg`
</ParamField>

## 响应信息

<ResponseField name="image_urls" type="string[]" required={true}>
  编辑后的图片 URL 列表
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  模型 grounding 元数据。Google 服务端工具（例如搜索）被调用时返回。注意：工具调用取决于 Google。参数启用工具，不一定 100% 触发工具调用。
</ResponseField>