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