Соотношения и размеры
Размеры изображений, которые можно передать в поле size API Cheapest Imagen: до 19 соотношений сторон в 1K, 2K и 4K, а также свои размеры.
Передайте одно из этих значений в size. Любое разрешение стоит одинаково: цена модели за изображение.
Обычные gpt-image-2, gpt-image-2.5 и gpt-image-2.6 работают только в 1K и используют первый столбец; все остальные модели используют последние три.
| Соотношение | GPT Image 2 / 2.5 / 2.6 (1K) | Другие модели, 1K | 2K | 4K |
|---|---|---|---|---|
| 1:1 | 1024x1024 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 1536x1024 | 2048x1360 | 3504x2336 |
| 2:3 | 1024x1536 | 1024x1536 | 1360x2048 | 2336x3504 |
| 4:3 | 1443x1090 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 1090x1443 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1672x941 | 1280x720 | 2048x1152 | 3840x2160 |
| 9:16 | 941x1672 | 720x1280 | 1152x2048 | 2160x3840 |
| 5:4 | 1408x1120 | 1120x896 | 2240x1792 | 3200x2560 |
| 4:5 | 1120x1408 | 896x1120 | 1792x2240 | 2560x3200 |
| 21:9 | 1920x832 | 1456x624 | 2912x1248 | 3840x1648 |
| 9:21 | 832x1920 | 624x1456 | 1248x2912 | 1648x3840 |
| 2:1 | 1792x896 | 1536x768 | 3072x1536 | 3840x1920 |
| 1:2 | 896x1792 | 768x1536 | 1536x3072 | 1920x3840 |
| 3:1 | – | – | 2048x688 | 3840x1280 |
| 1:3 | – | – | 688x2048 | 1280x3840 |
| 4:1 | – | 2048x512 | 4096x1024 | 8192x2048 |
| 1:4 | – | 512x2048 | 1024x4096 | 2048x8192 |
| 8:1 | – | 3072x384 | 6144x768 | 12288x1536 |
| 1:8 | – | 384x3072 | 768x6144 | 1536x12288 |
1K, 2K и 4K работают на nano-banana-2, nano-banana-2.1, nano-banana-pro, gpt-image-2-adobe, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare и gpt-image-2.6-sunburst. Стабильные каналы Nano Banana создают разрешения из своего названия: nano-banana-2-1k и nano-banana-pro-1k — 1K, nano-banana-2-2k — 2K, nano-banana-2-4k и nano-banana-pro-4k — 4K, nano-banana-pro-2k — 1K или 2K. При size auto модель с одним разрешением использует своё.
Какие соотношения предлагает модель:
- Первые десять (от 1:1 до 21:9) работают на всех моделях.
- 9:21, 2:1 и 1:2 работают на моделях GPT; 3:1 и 1:3 — на моделях GPT в 2K и 4K.
- 4:1, 1:4, 8:1 и 1:8 работают только на
nano-banana-2иnano-banana-2.1.
Свои размеры
gpt-image-2-adobe и gpt-image-2.5-flare принимают также ваши собственные ширину и высоту, например 1600x896. Обе стороны должны быть кратны 16, длинная сторона не более 3840 px и не более чем втрое длиннее короткой, а изображение — от 655 360 до 8 294 400 пикселей. Свой размер стоит так же, как любой другой.
Точные пиксели
Обычные gpt-image-2, gpt-image-2.5 и gpt-image-2.6 могут вернуть чуть другие пиксели, чем вы запросили, при том же соотношении сторон: в тесте 17 ноября 2026 года 1024x1024 вернулось как 1254x1254, а 1792x896 — как 1774x887. Остальные модели GPT возвращают точный размер.
Nano Banana работает от соотношения сторон и разрешения: точные пиксели — то, что вернёт Google, при соотношении и разрешении переданного размера.
Лимиты
Большие изображения создаются в меньшем числе за запрос: не более 10 в 1K, 4 в 2K и 2 в 4K. При превышении возвращается 400, у которого param равен n.
auto — значение по умолчанию: модель сама выбирает размер, подходящий к промпту.
Любое другое значение отклоняется ошибкой 400, у которой param равен size. Какие размеры принимает модель, перечислено в справочнике API.
Правка изображений
Изображение по изображению через API Cheapest Imagen. Отправьте опорные изображения на /v1/images/edits файлами или ссылками и опишите изменение.
Синхронные и асинхронные запросы
Два способа вызвать API изображений: дождаться изображения в одном запросе или передать async true, сразу получить id задачи и читать задачи опросом либо через вебхук.