Переход с Nano Banana 2 на 2.1: что нужно изменить в API

Nano Banana 2.1 продолжает использовать асинхронный интерфейс задач HiAPI, поэтому объём изменений в коде невелик, но несколько ограничений на входные данные нужно перепроверить. Самое заметное изменение — значение model; также изменились количество референсных изображений и размер одного файла. Цены следует сверять с актуальной страницей и записями о задачах на момент публикации.

Эта статья основана на контракте интерфейса, который сейчас отображается на странице модели Nano Banana 2 и странице модели Nano Banana 2.1. Примеры используют структуру запросов из текущей документации; перед переключением производственного трафика их следует проверить на тестовом аккаунте с балансом.

Минимальное изменение — замена model

Обе версии создаются через асинхронную задачу:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

Если исходный запрос был генерацией изображения по тексту, основной задачей миграции будет изменение model:

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

В документации по-прежнему используется интерфейс POST /v1/tasks. После принятия запроса интерфейс создания возвращает ID задачи, который используется для опроса или обработки через callback. Существующий процесс опроса или callback можно продолжать использовать, но нужно перепроверить текущие поля статуса задачи и результата.

Поля, которые можно сохранить, и ограничения, которые нужно перепроверить

Текущий контракт 2.1 сохраняет常用 входные поля версии 2: prompt, необязательный image_input, aspect_ratio, resolution и output_format. Приведённый ниже smoke-тест на аккаунте с балансом успешно принял как генерацию по тексту, так и форму с референсным изображением; при正式ном переключении всё равно нужно проверять актуальный контракт по мере изменения версии.

Ограничения на референсные изображения изменились. На странице Nano Banana 2 указано до 14 изображений, по 10 MB каждое; на странице 2.1 указано до 10 изображений, по 30 MB каждое. Если заменить только ID модели и продолжить передавать старые 14 изображений, запрос превысит новый лимит. Клиент должен проверять количество по новому лимиту и решать, обрезать ли список или сразу сообщать пользователю.

На странице модели 2.1 не опубликован вход mask. При миграции не следует самостоятельно добавлять поле mask, если только в последующей документации интерфейса оно не будет явно указано. Для редактирования изображения исходное изображение передаётся через image_input, а в prompt нужно чётко описать, что изменить и какие детали сохранить.

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

Этот запрос успешно выполнен в smoke-тесте на аккаунте с балансом; изображение результата можно посмотреть здесь. На странице 2.1 сейчас указано, что референсные изображения поддерживают JPEG, PNG, WebP, размер каждого — не более 30 MB.

Цены нужно сверять на двух уровнях

На момент проверки страницы модели 2026-10-16 для Nano Banana 2.1 тарифы 1K, 2K и 4K отображались как 44, 72 и 116 кредитов соответственно. Перед планированием бюджета смотрите актуальную страницу цен и страницу модели; обратное чтение списания всё ещё требует отдельной проверки.

Не записывайте промо-цену или цифру с какой-либо страницы аккаунта как долгосрочную фиксированную цену. При проверке перед запуском фиксируйте разрешение, сумму, показанную перед отправкой, и фактическое списание после завершения задачи.

Переключение двух model ID на одном и том же промпте

Чтобы проверить путь миграции, мы отправили один и тот же промпт 1K, 1:1 с двумя публичными model ID. Оба запроса успешно создали задачи и достигли статуса success. Детали бутылки и столешницы на двух изображениях различаются, поэтому этот набор результатов подходит для проверки маршрутизации и обработки результатов, но недостаточен для ранжирования качества изображения и не доказывает идентичность товара.

Промпт, использованный в обоих запросах:

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

Маршрут	Model ID	Результат
Nano Banana 2	nano-banana-2	1K, 1:1, PNG, задача успешно завершена
Nano Banana 2.1	gemini-nano-banana-2.1	1K, 1:1, PNG, задача успешно завершена

Эта проверка миграции показывает, что model ID 2.1 принимает структуру задачи генерации изображения по тексту из текущей документации и возвращает изображение через тот же асинхронный процесс. Различия в изображениях в одной выборке можно рассматривать только как наблюдение, а не как результат сравнительной оценки моделей.

Чек-лист перед запуском

1. Замените nano-banana-2 на точный ID новой версии: gemini-nano-banana-2.1.
2. Сохраните асинхронный процесс POST /v1/tasks и существующую обработку статусов задач.
3. Проверьте, что image_input — это массив публичных URL изображений, не более 10 штук.
4. Замените предположение о 10 MB на изображение из старой версии на текущее ограничение 30 MB, указанное на странице 2.1.
5. Сохраните prompt, aspect_ratio, resolution, output_format и удалите поля без документального обоснования, например mask.
6. На тестовом аккаунте отправьте отдельно задачу только с текстом и задачу редактирования с референсным изображением, сохраните запросы, ID задач, итоговые статусы, URL результатов и сумму списания.
7. Сравните результаты и обработку ошибок со старой версией, после чего переключите модель по умолчанию для всех пользователей.

Обратное чтение цены и дальнейшее сопровождение

Приведённый выше smoke-тест проверил структуру запросов для генерации по тексту и изображения по изображению, создание задач, успешный итоговый статус и URL результата. Списание не было независимо считано по завершённой задаче, поэтому производственные затраты по-прежнему следует сверять с актуальной страницей цен и записями о задачах. Если перед публикацией контракт или ограничения на странице модели изменятся, их также нужно перепроверить.

Частые вопросы

Нужно ли менять интерфейс при переходе на Nano Banana 2.1?

Сейчас обе страницы моделей используют POST /v1/tasks. Сначала измените ID модели, затем проверьте входные данные и структуру ответа реальными запросами.

Можно ли по-прежнему использовать nano-banana-2?

Этот ID по-прежнему обозначает Nano Banana 2. Для вызова 2.1 следует использовать gemini-nano-banana-2.1.

Можно ли после миграции передавать 14 референсных изображений?

Текущий лимит, указанный на странице модели 2.1, — 10 изображений. При превышении количества клиент должен уменьшить список или отклонить запрос.

Нужен ли другой интерфейс для редактирования по референсному изображению?

На текущей странице нет отдельного интерфейса редактирования. Продолжайте использовать тот же ID модели, добавьте image_input и укажите в промпте, что изменить и какие детали сохранить.

Дешевле ли 2.1 для всех аккаунтов?

На публичной странице сейчас указаны более низкие стандартные значения кредитов для каждого разрешения, но цены могут меняться, а на страницу также могут влиять статус аккаунта или акции. Прежде чем делать выводы о стоимости, сверяйте актуальную цену и записи о списании после завершения задач.

Дополнительные материалы

• Руководство по подключению API Nano Banana 2.1
• Цены API Nano Banana 2.1
• Как использовать API Nano Banana 2

Попробуйте Nano Banana 2.1 на странице модели HiAPI.