Gemini Image API: размеры, aspectRatio и imageSize

Точная таблица разрешений Gemini Image API: aspectRatio, imageSize, 1K, 2K и 4K, поля generationConfig и пример generateContent через NeuroAPI.

Это руководство отвечает на практический вопрос: какое разрешение вернёт Gemini Image API при заданном aspectRatio и imageSize. Для нативного Gemini-совместимого запроса NeuroAPI используйте POST /v1beta/models/{model}:generateContent.

Коротко: соотношение сторон передаётся в generationConfig.imageConfig.aspectRatio, а класс разрешения — в generationConfig.imageConfig.imageSize. Значения 1K, 2K и 4K пишутся с заглавной K.

Параметры Gemini Image API

Поле	Пример	Что задаёт
`generationConfig.responseModalities`	`["TEXT", "IMAGE"]`	Какие типы частей вернуть в ответе
`generationConfig.imageConfig.aspectRatio`	`"9:16"`	Соотношение сторон результата
`generationConfig.imageConfig.imageSize`	`"2K"`	Класс разрешения для поддерживающей его модели

imageSize — не произвольное число пикселей. Это пресет, который модель переводит в точную пару ширины и высоты с учётом aspectRatio.

Таблица разрешений Gemini 3.1 Flash Image и Gemini 3 Pro Image

Для общих соотношений сторон точные размеры 1K, 2K и 4K совпадают у Gemini 3.1 Flash Image и Gemini 3 Pro Image.

`aspectRatio`	`imageSize: "1K"`	`imageSize: "2K"`	`imageSize: "4K"`
`1:1`	`1024x1024`	`2048x2048`	`4096x4096`
`2:3`	`848x1264`	`1696x2528`	`3392x5056`
`3:2`	`1264x848`	`2528x1696`	`5056x3392`
`3:4`	`896x1200`	`1792x2400`	`3584x4800`
`4:3`	`1200x896`	`2400x1792`	`4800x3584`
`4:5`	`928x1152`	`1856x2304`	`3712x4608`
`5:4`	`1152x928`	`2304x1856`	`4608x3712`
`9:16`	`768x1376`	`1536x2752`	`3072x5504`
`16:9`	`1376x768`	`2752x1536`	`5504x3072`
`21:9`	`1584x672`	`3168x1344`	`6336x2688`

Отсюда два часто встречающихся размера:

768x1376 — вертикальный 9:16 в пресете 1K;
848x1264 — вертикальный 2:3 в пресете 1K.

У Gemini 3.1 Flash Image есть также пресет 512 и дополнительные экстремальные пропорции. Не переносите их автоматически на другие модели: набор поддерживаемых значений зависит от точной модели.

Ограничения по моделям

Модель	Разрешение	Важное ограничение
Gemini 3.1 Flash Image	`512`, `1K`, `2K`, `4K`	Дополнительные широкие и узкие пропорции зависят от модели
Gemini 3 Pro Image	`1K`, `2K`, `4K`	Нет пресета `512`
Gemini 3.1 Flash Lite Image	только `1K`	`2K` и `4K` для этой модели не поддерживаются
Gemini 2.5 Flash Image	фиксированный размер по пропорции	Поле `imageSize` не выбирает 2K/4K

Gemini 2.5 Flash Image

`aspectRatio`	Разрешение
`1:1`	`1024x1024`
`2:3`	`832x1248`
`3:2`	`1248x832`
`3:4`	`864x1184`
`4:3`	`1184x864`
`4:5`	`896x1152`
`5:4`	`1152x896`
`9:16`	`768x1344`
`16:9`	`1344x768`
`21:9`	`1536x672`

Пример generateContent с `aspectRatio` и `imageSize`

Следующий запрос просит Gemini 3.1 Flash Image вернуть вертикальное изображение 2K. Используйте модель, которая опубликована в текущем каталоге NeuroAPI.

curl "https://neuroapi.host/v1beta/models/gemini-3.1-flash-image:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Создай вертикальный рекламный постер для российского API-сервиса"
      }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16",
        "imageSize": "2K"
      }
    }
  }'

Изображение находится в candidates[].content.parts[].inlineData.data. Значение закодировано в Base64; MIME-тип приходит рядом в inlineData.mimeType.

import base64

for candidate in response["candidates"]:
    for part in candidate["content"]["parts"]:
        inline = part.get("inlineData")
        if inline and inline.get("data"):
            with open("result.png", "wb") as file:
                file.write(base64.b64decode(inline["data"]))

Как выбрать размер

Для карточек и аватаров начните с 1:1 и 1K.
Для вертикальной рекламы используйте 9:16; для постера с менее вытянутой композицией — 2:3.
Для hero-баннеров обычно подходят 16:9 или 21:9.
Переходите на 2K или 4K, только если конечный макет действительно требует большего холста: размер увеличивает объём результата и время обработки.
Не подставляйте точные пиксели вместо пресета: в GenerateContent передаются aspectRatio и imageSize, а итоговую ширину и высоту выбирает модель по таблице.

Источник и актуальность

Таблицы сверены 10 августа 2026 года с официальным руководством Image generation — Gemini API и справкой GenerateContent ImageConfig.

Официальный контракт и набор моделей могут меняться. Эта страница объясняет поддерживаемую форму запроса NeuroAPI, но не обещает постоянную публикацию каждой модели: перед production-запуском проверьте живой каталог и цену, а общий OpenAI Images контракт смотрите в разделе Изображения.