Семейство Nano Banana
Модели изображений Gemini от Google, всего пять. Рекомендуется вызывать их через нативный эндпоинт Gemini — он позволяет точно задать соотношение сторон и разрешение; OpenAI-совместимый эндпоинт тоже работает, но поддерживает только часть параметров.
Типичные задачи
Выбор модели
- Три уровня: 1K, 2K, 4K
- Соотношения от 1:8 до 8:1; 2K и 4K по замерам около 2 минут
- Четыре уровня разрешения: от 512 до 4K
- Больше всего соотношений сторон, включая 1:8 и 8:1
- Три уровня: 1K, 2K, 4K
- Перед генерацией выполняет рассуждение, поэтому работает дольше
- Только 1K
- По замерам около 5 секунд на изображение, вывод в JPEG
- Фиксированно около 1K, разрешение задать нельзя
- Можно продолжать использовать в существующих проектах
google/gemini-nano-banana-2.1Новейшаяgoogle/gemini-3.1-flash-imageДля повседневных задачgoogle/gemini-3-pro-image4K, сложная композицияgoogle/gemini-3.1-flash-lite-imageТолько 1Kgoogle/gemini-2.5-flash-imageПредыдущее поколениеАктуальные цены см. на страницах моделей: Nano Banana 2 , Nano Banana Pro . Фактическое списание определяется полем usageMetadata в ответе.
Выбор эндпоинта
Задержка и таймауты
API синхронный. По замерам, 1K занимает около 5–20 секунд, 4K — около 30 секунд; 2K и 4K у Nano Banana 2.1 — около 2 минут. В часы пиковой нагрузки задержка больше. Pro перед генерацией изображения выполняет рассуждение (в ответе есть thoughtsTokenCount), поэтому работает дольше, чем Nano Banana 2 при том же разрешении. Типичного таймаута по умолчанию в 60 секунд недостаточно для 4K и запросов в часы пик; если клиент разорвёт соединение, запрос всё равно будет оплачен.
Структура ответа
{
"candidates": [{
"content": {
"parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
"role": "model"
},
"finishReason": "STOP"
}],
"modelVersion": "google/gemini-3-pro-image",
"usageMetadata": {
"promptTokenCount": 7,
"candidatesTokenCount": 2000,
"candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
"thoughtsTokenCount": 211,
"totalTokenCount": 2218
}
}- Изображение находится в элементе
parts, содержащемinlineData, и это не обязательно первый элемент — перед ним может быть текст. Перебирайтеparts, чтобы его найти. - Значение элемента
IMAGEвcandidatesTokensDetails— это число токенов выходного изображения. По замерам: 1 120 для 1K и 2 000 для 4K у Pro. thoughtsTokenCountвстречается только в ответах Pro и обозначает токены рассуждения перед генерацией изображения.
Официальная документация
Официальная документация описывает поведение при прямом обращении к Google; при вызове через OfoxAI приоритет имеют выводы из замеров на этой странице.
- Gemini API · Генерация изображений
- Gemini API · Соотношение сторон и разрешение при генерации изображений
- OfoxAI · Нативный протокол Gemini generateContent
Часто задаваемые вопросы
Как сгенерировать изображение 4K с Nano Banana Pro?
Используйте нативный эндпоинт Gemini: передайте imageSize: "4K" в generationConfig.imageConfig и задайте соотношение сторон через aspectRatio. По замерам, 4K с соотношением 16:9 даёт 5504x3072, около 16 МБ, за примерно 33 секунды. OpenAI-совместимый эндпоинт не поддерживает imageSize — при передаче image_size возвращается 400.
Какие соотношения сторон поддерживает Nano Banana 2?
10 распространённых: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9; а также четыре сверхшироких или сверхвытянутых: 1:4, 4:1, 1:8, 8:1. Для соотношений не из этого списка возвращается 400 Request contains an invalid argument.
Поддерживает ли Nano Banana Pro 1:8 или 4:1?
Нет. Соотношения 1:4, 4:1, 1:8 и 8:1 поддерживают только Nano Banana 2.1, Nano Banana 2 и Nano Banana 2 Lite; для сверхвытянутых или сверхшироких изображений используйте одну из этих трёх моделей.
Писать imageSize как 4K или 4k?
Рекомендуется писать заглавными: 1K, 2K, 4K — как в официальной документации Google. По замерам, OfoxAI принимает и строчные. Уровень 512 пишется без K и поддерживается только Nano Banana 2.
Как задать соотношение сторон Nano Banana через OpenAI-совместимый эндпоинт?
Используйте aspect_ratio на верхнем уровне, например "16:9". Этот эндпоинт не поддерживает параметры разрешения; для 2K и 4K используйте imageConfig.imageSize нативного эндпоинта Gemini.
Может ли Nano Banana сгенерировать несколько изображений за раз?
Нет, один запрос генерирует одно изображение. Если нужно несколько, отправляйте несколько запросов параллельно с учётом лимитов частоты запросов.
Какой таймаут установить для Nano Banana?
Рекомендуется 300 секунд или больше. По замерам, 1K занимает около 5–20 секунд, 4K — около 30 секунд, 2K и 4K у Nano Banana 2.1 — около 2 минут; в часы пик дольше. Pro перед генерацией выполняет рассуждение, поэтому работает дольше, чем Nano Banana 2.