API Nano Banana
ИИ-изображенияNano Banana — исходный маршрут Google Gemini 2.5 Flash Image в OmniaKey с генерацией по тексту и правкой по референсу через media API.
- За успешный вызов$0,019
- ОперацииТекст в изображение
- Редактирование изображения
- Посмотреть цены на инструменты и правила оплаты
Результат появится здесь после запуска модели.
01
Для чего подходит
Nano Banana — исходный маршрут Google Gemini 2.5 Flash Image в OmniaKey с генерацией по тексту и правкой по референсу через media API.
Используйте Nano Banana в существующих сценариях Gemini 2.5. Nano Banana 2 стоит столько же в 1K и предлагает более крупные изображения.
02
Что умеет
Текст в изображение
gemini-2.5-flash-image
Создаёт новое изображение по текстовому описанию.
Редактирование изображения
gemini-2.5-flash-image
Изменяет готовое изображение по описанию и референсу.
03
Подробно
Nano Banana — оригинальная модель Gemini 2.5 Flash Image от Google на OmniaKey, она числится как gemini-2.5-flash-image и умеет работать в режимах text-to-image и image-edit. Nano Banana — это название продукта Google для нативной генерации и редактирования изображений Gemini, и здесь это самый старый представитель семейства: в каталоге для него указана одна ставка за вызов, без градации по размеру и без preview-алиаса рядом.
В нашей работе эта модель пригодилась вовсе не для победы в сравнении. Мы делали с её помощью исходные картинки, которые затем редактировали другие модели, поэтому ни одна модель не оценивала собственный результат, а нейтральный кадр — как раз то, что хорошо удаётся старой модели. Это также ID модели, который уже вызывается в существующем коде Gemini 2.5.
Решение определяют два ограничения. В каталоге для этого ID модели нет шага до 2K или 4K, поэтому для крупного результата нужна другая модель; а улучшения, которые Google выпустил позже — в отрисовке текста, референсных изображениях и многошаговом редактировании, — относятся к новым ID моделей. Оставьте эту модель для преемственности и исходных материалов, а новые задачи начинайте на Nano Banana 2.1 или Pro.
Нейтральные кадры для тестов редактирования
Когда несколько моделей должны отредактировать одну и ту же картинку, сделайте эту картинку здесь. Так и было в нашем октябрьском раунде из шести тестов: ни одну модель не просили улучшить собственный результат, и сравнение осталось честным. Держите исходник простым, задайте свет и композицию один раз и используйте этот файл везде.
Существующий код Gemini 2.5
Клиенты, написанные под поколение 2.5, продолжают работать без переписывания: та же структура задачи, та же операция редактирования, одна ставка за вызов. Закрепите ID модели в конфигурации, а не прописывайте его жёстко, чтобы последующий переход на gemini-nano-banana-2.1 стал изменением настроек и повторным прогоном вашего набора примеров.
Простые кадры товаров и повседневных сцен
Простые задачи по-прежнему дают годный результат: один объект, дневной свет, чистый фон, без плотного текста. Не используйте эту модель для постеров, колонок с ценами или группы людей, которые должны оставаться узнаваемыми, — на такие задачи лучше выделить более новую модель, а не растягивать возможности этой.
04
Ограничения
- В каталоге для этого ID модели указана одна ставка за вызов и нет градации по размеру, поэтому смотрите на фактические размеры результата, а не рассчитывайте на полотно 2K или 4K.
- Это самый старый представитель семейства здесь: работа над текстом, референсами и многошаговым редактированием, выпущенная Google позже, относится к новым ID моделей, а не к этой.
- Google сообщает, что сгенерированные изображения несут водяной знак SynthID, который отмечает происхождение и ничего не говорит о правильности картинки.
- При редактировании исходник передаётся внутри тела запроса размером до 1 MiB, поэтому полноразмерный файл с камеры нужно уменьшить, прежде чем задачу можно будет создать.
05
Сравнение близких моделей
| Модель | Лучше всего для | Операции | Цена в каталоге |
|---|---|---|---|
| Nano BananaЭта страница gemini-2.5-flash-image | Существующие рабочие процессы 2.5 и нейтральные исходные кадры по одной указанной ставке за вызов. | Текст в изображение · Редактирование изображения | $0,019 за вызов |
| Nano Banana 2.1 gemini-nano-banana-2.1 | Новая работа с точной отрисовкой букв, десятью референсами объектов и результатом от 1K до 4K. | Текст в изображение · Редактирование изображения | $0,019–$0,039 за вызов |
| Nano Banana Pro gemini-3-pro-image | Сложные макеты и редактирование портретов, где верхний указанный тариф даёт физическую детализацию. | Текст в изображение · Редактирование изображения | $0,039–$0,069 за вызов |
06
Источники и проверка
Руководство обновлено 2026-10-27.
07
Как вызывать
Медиамодели работают асинхронно: создайте задачу, опрашивайте её до завершения, затем скачайте подписанный URL результата.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gemini-2.5-flash-image-001" \
-d '{
"model": "gemini-2.5-flash-image",
"type": "image",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"aspect_ratio": "1:1"}
}'
# 2. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 3. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"08
Стоимость
Задачи с изображениями тарифицируются за успешный вызов, а не за токены. Неудачные и отменённые задачи возвращаются автоматически.
$0,019за вызовЭкономия 51%
Другие модели изображений Google
Похожие статьи
API изображений Gemini через прокси
Выберите формат API, создайте изображение и продолжите работу после тайм-аута без повторного создания задачи.
Читать статьюGPT Image 2.5 vs Nano Banana 2.1: тест на одинаковых промптах и цена
Четыре промпта, три модели изображений, один день: что получилось у каждой и во сколько это обошлось.
Читать статьюQwen Image 3 vs Nano Banana 2.1: тест с одинаковым промптом и цены
Четыре промпта, две модели изображений, один день: что получилось и сколько это стоило.
Читать статьюnano banana 2.1 vs pro
Шесть задач, одинаковые запросы, три модели: что создала каждая и какую выбрать.
Читать статьюЧастые вопросы
Как вызвать Nano Banana в OmniaKey?
Отправьте POST на /v1/media/tasks с id модели, type "image" и operation "generate" или "edit". При повторах используйте один и тот же Idempotency-Key, чтобы таймаут не создал вторую платную задачу.
Сколько стоит Nano Banana?
Nano Banana тарифицируется как $0,019 за вызов. При создании эта сумма резервируется из предоплаченного баланса, а неудачные и отменённые задачи возвращаются автоматически.
Почему API возвращает id задачи, а не изображение?
Задержка провайдера — от секунд до минуты, поэтому OmniaKey приводит все маршруты изображений к одному асинхронному циклу. Опрашивайте GET /v1/media/tasks/{id}, пока статус не станет succeeded, затем читайте подписанный URL результата.
Nano Banana — это то же самое, что Nano Banana 2?
Нет. Nano Banana — название продукта Google для нативной генерации изображений Gemini, и этот ID модели, gemini-2.5-flash-image, — самый старый представитель семейства на платформе. В Nano Banana 2 используется gemini-3.1-flash-image, а в Nano Banana 2.1 — gemini-nano-banana-2.1, каждая из них отдельная модель со своим поведением.
Может ли эта модель создать изображение 4K?
В каталоге для этого ID модели нет шагов по размеру, поэтому рассчитывайте на размер, который она возвращает, а не на полотно, которое вы выбираете. Если нужен файл 4K, в Nano Banana 2 и 2.1 указан диапазон от 1K до 4K, а Pro добавляет свой более высокий верхний тариф над ними.
Как считается оплата на этой модели?
Одно изображение за вызов по одной ставке, без шагов по размеру, поэтому повторение одной и той же задачи каждый раз стоит одинаково. Текущая ставка указана в таблице цен на странице модели. Неудачная задача возвращает зарезервированный кредит, а истёкшую ссылку на ресурс можно обновить, повторно опросив ту же задачу.
Зачем держать в стеке старую модель изображений?
Для преемственности и исходных материалов: промпты, которые уже прошли проверку, продолжают работать, а нейтральному кадру для сравнения редактирования не нужна самая сильная модель. Новые задачи с плотным текстом, несколькими референсами или большим полотном лучше отдавать новому ID модели.
Добавляет ли она водяной знак на картинку?
Google сообщает, что сгенерированные изображения включают водяной знак SynthID, и эта модель относится к этому семейству. Эта метка — метаданные о происхождении, а не видимый логотип, и она ничего не говорит о том, правильно ли вышли подпись, количество или лицо.
