> ## 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 Image Editing

Edit images with natural language prompts using the Gemini 3.1 Flash model. Supports URL and Base64-encoded images as input, with up to 14 reference images.

## Request Headers

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API key}}.
</ParamField>

## Request Body

<ParamField body="size" type="string" default="1K">
  The pixel size of the output image. 0.5K (about 512px), 1K (about 1024px), 2K (about 2048px), 4K (about 4096px). Defaults to 1K.

  Available values: `0.5K`, `1K`, `2K`, `4K`
</ParamField>

<ParamField body="google" type="object">
  Google Search options

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      Enable Google Web Search to generate more accurate images based on real-world information.
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      Enable Google Image Search to use real images as visual references for generation.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text prompt describing the desired image editing effect
</ParamField>

<ParamField body="image_urls" type="string[]">
  List of input image URLs to edit. Supports up to 14 reference images.

  Array length: 0 - 14
</ParamField>

<ParamField body="aspect_ratio" type="string">
  The aspect ratio of the output image. Supports standard ratios and newly added ultra-wide/ultra-tall ratios (1:4, 4:1, 1:8, 8:1)

  Available values: `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[]">
  List of Base64-encoded images to edit. The total number of image\_urls and image\_base64s cannot exceed 14.

  Array length: 0 - 14
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  The MIME type of the output image. Supported formats: image/png, image/jpeg. Defaults to image/png.

  Available values: `image/png`, `image/jpeg`
</ParamField>

## Response Information

<ResponseField name="image_urls" type="string[]" required={true}>
  List of edited image URLs
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  Model grounding metadata. Returned when Google server-side tools (such as Search) are called. Note: Tool calls depend on Google. Enabling tools does not guarantee that a tool call will be triggered 100% of the time.
</ResponseField>