> ## 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 Image Preview для генерации изображений по текстовым подсказкам. Поддерживаются настраиваемые размеры изображения, соотношение сторон и глубина рассуждения для получения результатов более высокого качества.

## Заголовки запроса

<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) доступен только для Gemini 3.1 Flash.

  Возможные значения: `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="aspect_ratio" type="string" default="1: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="output_format" type="string" default="image/png">
  MIME-тип выходного изображения; поддерживаются форматы PNG и JPEG.

  Возможные значения: `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>