Как пользоваться Nano Banana 2.1 API? Первая картинка за 5 минут

TL;DR

• Что это: последняя версия серии Nano Banana от Google, генерация по тексту и редактирование по референсу используют один ID модели. Уже доступна на HiAPI, откройте страницу модели, введите промпт и генерируйте. Новым пользователям при регистрации дают 200 кредитов — хватит примерно на 4 изображения 1K.
• Сколько стоит: оплата за штуку, 1K — $0.022, 2K — $0.036, 4K — $0.058, примерно на 33%–39% дешевле Nano Banana 2, референсные изображения без наценки.
• Как вызывать API: POST https://api.hiapi.ai/v1/tasks, в model укажите gemini-nano-banana-2.1, получите taskId, затем опрашивайте или ждите callback, скачайте data.output[0].url.

О только что вышедшей Nano Banana 2.1 чаще всего спрашивают две вещи: что она умеет и как быстро её можно подключить к своему проекту. Первое — смотрите 5 пунктов ниже, второе — хватит 5 минут.

Что умеет Nano Banana 2.1?

• На 30–40% дешевле NB 2. При том же разрешении каждое изображение дешевле примерно на 33%–39%, 1K стоит всего $0.022, синтаксис параметров такой же, как у NB 2.
• До 10 референсных изображений за раз. Модель, одежда, сцена, продукт — всё загружается вместе и объединяется в одно изображение, подходит для смены нарядов и визуальных предложений для брендов.
• 15 форматов, вплоть до 1:8 и 8:1. Помимо привычных 1:1, 4:5, 16:9, 21:9, можно получить вытянутые изображения 1:4, 4:1, 1:8, 8:1 — длинные картинки для страниц товаров и баннеры создаются за один раз.
• Три разрешения: 1K, 2K, 4K. 1K — для отладки промптов, 2K и 4K — для финальных изображений.
• Генерация по тексту и редактирование — один ID модели. Только промпт — генерация по тексту, добавьте референс — получите редактирование, код не нужно разделять на два набора.

Модный снимок Nano Banana 2.1, 2K / 16:9, выход 2752×1536.

Сгенерировать с этим промптом →

Два пути: онлайн-тест или API?

Сначала посмотрите результат — выберите онлайн-тест, если нужно встроить в продукт — выбирайте API. Оба пути используют одну модель и одну цену.

Онлайн-тест (около 1 минуты)

1. Откройте страницу модели Nano Banana 2.1 или сразу перейдите по ссылке под изображением выше — промпт заполнится автоматически.
2. Зарегистрируйтесь или войдите, новый аккаунт получает 200 кредитов.
3. Выберите формат и разрешение, 1K — 44 кредита за штуку.
4. Нажмите «Сгенерировать», если понравилось — скачайте.

Интеграция через API (около 5 минут)

1. Создайте API Key (sk-...) в консоли HiAPI.
2. POST /v1/tasks создаёт задачу, в ответе получите data.taskId.
3. Запрашивайте через GET /v1/tasks/{id} или передайте callback.url в запросе и ждите уведомления.
4. Когда data.status станет success, скачайте изображение из data.output[0].url.

1K стоит $0.022 за штуку, на $10 можно сгенерировать около 450 изображений — достаточно, чтобы довести промпт до идеала. Полные параметры — в китайской документации.

Первое изображение: версия на curl

Создание задачи:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A fashion editorial photograph of a model in an ivory linen blazer on a sunlit white-stucco terrace above the Mediterranean, 50mm lens, soft directional light, cinematic color grade",
      "aspect_ratio": "4:5",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

ID созданной задачи находится в data.taskId:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

Проверка результата:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-YOUR_KEY"

Обязателен только prompt. aspect_ratio по умолчанию auto, resolution по умолчанию 1K, output_format может быть jpg или png.

Первое изображение: версия на Python

Создание, опрос и скачивание в одном скрипте — скопируйте, замените ключ на свой и запускайте:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer sk-YOUR_KEY"}

payload = {
    "model": "gemini-nano-banana-2.1",
    "input": {
        "prompt": "A fashion editorial photograph of a model in an ivory linen blazer on a sunlit white-stucco terrace above the Mediterranean, 50mm lens, soft directional light, cinematic color grade",
        "aspect_ratio": "4:5",
        "resolution": "2K",
        "output_format": "png",
    },
}

resp = requests.post(API, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    status = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if status["status"] in ("success", "fail"):
        break
    time.sleep(2)

if status["status"] == "success":
    image_url = status["output"][0]["url"]
    with open("nano-banana-2-1.png", "wb") as f:
        f.write(requests.get(image_url, timeout=60).content)
else:
    print(status.get("error"))

Редактирование по референсу: достаточно добавить одно поле

Добавьте image_input в input — тот же запрос станет редактированием. Ниже берём тот же модный снимок как референс и меняем только цвет пиджака:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "Change the model'\''s blazer to deep burgundy silk while keeping her pose, the terrace, and the lighting unchanged",
      "image_input": ["https://static.hiapi.ai/model-examples/gemini-nano-banana-2.1/2026/10/08/1791466473082-3e77d5c2a1ef0ef6-coastal-fashion-2k.webp"],
      "resolution": "2K"
    }
  }'

В image_input можно передать до 10 публичных URL, поддерживаются JPEG, PNG, WebP, размер одного файла не более 30 МБ. В промпте разделяйте «что изменить» и «что сохранить»: чем конкретнее сохраняемые элементы, тем стабильнее исходное изображение.

3 вещи, которые стоит учесть перед запуском

1. На сервере используйте callback. Добавьте в тело запроса "callback": {"url": "https://yourapp.com/webhook", "when": "final"} — по завершении задачи придёт уведомление, опрос не нужен.
2. При таймауте не повторяйте POST. Каждый POST /v1/tasks создаёт новую задачу и оплачивается отдельно. Сначала сохраните taskId, а перед повтором выполните дедупликацию в своей системе.
3. Явно указывайте resolution в каждом запросе. Разрешение напрямую определяет цену — прописывайте его в запросе, чтобы счёт был предсказуемым.

Частые ошибки, по одной на строку

• 400 additional properties '<field>' not allowed → имя поля написано с ошибкой или использовано поле другой модели (например, image_urls) → сверьтесь с документацией и исправьте на правильное имя, например image_input.
• 400, сообщение о неверном значении aspect_ratio → передан формат, которого нет в списке → выберите одно из 15 допустимых значений, перечисленных в ошибке.
• 401 permission_denied → ключ отсутствует, написан с ошибкой или отозван → проверьте заголовок Authorization: Bearer sk-..., при необходимости пересоздайте ключ в консоли.
• Задача создана, но статус fail / INVALID_REQUEST → URL референса не открывается или это не изображение → замените на JPEG, PNG или WebP, доступный публично.
• Ссылка на изображение через несколько дней не открывается → ссылка на результат имеет срок действия → скачивайте сразу после получения и сохраняйте файл.

Предварительно списанная сумма за неудачные задачи автоматически возвращается в полном объёме.

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

Можно ли заменить NB 2 на Nano Banana 2.1 напрямую? Да. Имена параметров полностью совпадают, достаточно изменить model на gemini-nano-banana-2.1, при том же разрешении каждое изображение дешевле примерно на 33%–39%. Единственное, что стоит учесть: 2.1 по умолчанию выводит JPG, если нужен PNG — явно укажите "output_format": "png".

Берут ли доплату за референсные изображения? Нет. Цена зависит только от разрешения вывода, 1 или 10 референсов — разницы нет.

Можно ли получить прозрачный фон? Формат вывода — jpg или png, для материалов с прозрачным фоном выбирайте GPT Image 2.5, он поддерживает background: transparent в 1K.

Сколько изображений за раз? Одна задача — одно изображение. Для нескольких создавайте несколько задач параллельно, оплата за штуку.

Статьи серии Nano Banana 2.1

• Страница модели Nano Banana 2.1: онлайн-генерация, 200 кредитов при регистрации
• Сколько стоит Nano Banana 2.1 API: цена за 1K/2K/4K и месячный бюджет
• Nano Banana 2.1 vs GPT Image 2.5: как выбрать по бюджету и сценарию
• Полный гид по промптам Nano Banana 2.1: 5 сценариев с готовыми промптами
• Документация по интеграции Nano Banana 2.1 на китайском: все параметры и коды ошибок

Попробуйте сейчас: нажмите Сгенерировать с этим промптом → под модным снимком выше — промпт уже заполнен, выберите 2K, 16:9 и нажмите, чтобы получить такой же результат.