Руководство по использованию

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

4 шага для онлайн-пробного запуска, 4 шага для подключения API, плюс готовые к запуску примеры curl и Python, редактирование по референсному изображению и быстрый справочник частых ошибок.

Oct 12, 2026

TL;DR

Что это: Gemini 3 Pro Image от Google, флагман линейки Nano Banana; генерация по тексту и редактирование по референсному изображению используют один и тот же ID модели nano-banana-pro. Уже доступна в HiAPI — откройте страницу модели, введите промпт и генерируйте. Новым пользователям при регистрации дают 200 кредитов — по обычной цене этого хватает на 1 изображение 2K.
Сколько стоит: оплата за изображение, 1K и 2K по одной цене $0.057, 4K — $0.1; считается за каждое выходное изображение, примерно на 57%–58% дешевле стандартной цены Google, за референсные изображения наценки нет.
Как вызывать API: POST https://api.hiapi.ai/v1/tasks, в model укажите nano-banana-pro, получите taskId, затем опрашивайте статус или ждите колбэка, скачайте data.output[0].url.

Стоимость входных токенов у Google считается отдельно; сравнение цен выше относится к цене за каждое выходное изображение.

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

2K без наценки. 1K и 2K — обе по $0.057 за изображение, можно сразу генерировать в 2K; 4K — $0.1 за изображение, оставьте его для печати и больших экранов.
Текст прямо в кадре. Вывески, заголовки постеров, даты и другие короткие английские фразы пишите прямо в промпте: две строки на золотой вывеске ниже получились правильно с первого раза, без какой-либо постобработки.
До 8 референсных изображений. Только промпт — это генерация по тексту; добавьте image_input — и это уже редактирование или слияние нескольких изображений. Тот же ID модели, не нужно поддерживать два набора кода.
10 форматов плюс auto. Есть все популярные пропорции: 1:1, 4:5, 3:4, 9:16, 16:9, 21:9 и другие. Если нужны вытянутые изображения вроде 1:4, 8:1 или больше 8 референсных изображений за раз, выбирайте Nano Banana 2 (до 14 изображений).

Оригинал Nano Banana Pro, без ретуши, вывод 1536×2752.

A hand-painted gold-leaf sign in a modern specialty coffee shop window, elegant serif lettering reading 'MORNING BREW CO.' with a small script subtitle 'est. 2024' beneath it, warm natural daylight streaming through the glass, soft bokeh reflections of a city street, photorealistic commercial photography, crisp perfectly legible typography with correct spelling, shallow depth of field, editorial lighting

Сгенерировать по этому промпту →, выберите формат 9:16 и разрешение 2K.

Два пути: онлайн-проба или API?

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

Онлайн-проба (около 1 минуты)

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

Подключение API (около 5 минут)

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

2K — $0.057 за изображение, на $10 получится около 175 изображений. Ограниченная скидка 50% ко Дню программиста до 00:00 по пекинскому времени 2026-11-09: в этот период 1K и 2K — по $0.0285 за изображение, и тех же $10 хватит примерно на 350 изображений. Полные параметры — в документации на китайском.

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

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

curl --fail-with-body -sS -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "input": {
      "prompt": "Minimalist studio product photography, matte-black earbuds case on a warm gradient backdrop, three-point studio lighting",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

Возвращённый ID задачи находится в data.taskId:

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

Запрос результата:

curl --fail-with-body -sS https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-YOUR_KEY"

Обязателен только prompt. aspect_ratio по умолчанию auto, resolution по умолчанию 1K, output_format по умолчанию png, также можно выбрать jpg. 1K и 2K стоят одинаково, поэтому рекомендуем в каждом запросе указывать "resolution": "2K".

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

Сначала установите requests (python3 -m pip install requests) и задайте HIAPI_API_KEY в терминале (export HIAPI_API_KEY="sk-YOUR_KEY"). Пример ниже создаёт задачу, опрашивает статус максимум 10 минут и затем скачивает изображение; после тайм-аута сохраните taskId и продолжайте опрос:

import os
import time
import requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

payload = {
    "model": "nano-banana-pro",
    "input": {
        "prompt": "Minimalist studio product photography, matte-black earbuds case on a warm gradient backdrop, three-point studio lighting",
        "aspect_ratio": "16:9",
        "resolution": "2K",
        "output_format": "png",
    },
}


def task_data(response):
    response.raise_for_status()
    body = response.json()
    if body.get("code") != 200:
        raise RuntimeError(f"HiAPI request failed: {body}")
    return body["data"]


task_id = task_data(requests.post(API, headers=HEADERS, json=payload, timeout=30))["taskId"]
print(f"taskId: {task_id}", flush=True)  # Save this ID for later queries.

deadline = time.monotonic() + 600
while time.monotonic() < deadline:
    task = task_data(requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30))
    if task["status"] == "success":
        image_url = task["output"][0]["url"]
        image = requests.get(image_url, timeout=60)
        image.raise_for_status()
        with open("nano-banana-pro.png", "wb") as f:
            f.write(image.content)
        break
    if task["status"] == "fail":
        raise RuntimeError(f"task {task_id} failed: {task}")
    time.sleep(3)
else:
    raise TimeoutError(f"task {task_id} is still pending; query this ID instead of submitting again")

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

Добавьте image_input в input — и тот же запрос станет редактированием. Ниже берём постер научного музея, сгенерированный Nano Banana Pro, как референс и меняем только строку с датой:

curl --fail-with-body -sS -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "input": {
      "prompt": "Keep this exact poster: layout, planet, observatory, visitor, colors and headline. Change only the date line to SAT 24 OCT in the same typography and color. No other words.",
      "image_input": ["https://static.hiapi.ai/blog/gpt-image-2-vs-nano-banana-pro/0dba86ff979d-nano-pro-science.png"],
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

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

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

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

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

400, сообщение о недопустимом поле → опечатка в имени поля или использовано поле другой модели (например, image_urls) → замените на image_input.
400, сообщение о неверном значении aspect_ratio → использован формат не из списка (например, 8:1) → выберите один из 10 форматов и auto; для вытянутых изображений переходите на Nano Banana 2.
401 → ключ отсутствует, указан неверно или отозван → проверьте заголовок Authorization: Bearer sk-... и при необходимости пересоздайте ключ в консоли.
Задача создана, но статус fail → посмотрите ошибку в ответе задачи; если референсное изображение не открывается или формат не поддерживается, замените его на доступный из публичной сети JPEG, PNG или WebP и отправьте снова.
Ссылка на изображение не открывается после истечения срока → ссылка на вывод имеет срок действия → скачивайте результат сразу и сохраняйте сам файл.

За неудачные задачи плата не списывается.

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

Как выбрать между Nano Banana Pro и Nano Banana 2? Для 2K оба стоят одинаково — $0.057 за изображение. Если нужны вытянутые форматы или больше 8 референсных изображений, выбирайте Nano Banana 2; если нужен флагман линейки Nano Banana для ключевых брендовых визуалов — выбирайте Pro.

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

Можно ли переключиться с Nano Banana 2 напрямую? Да. Имена полей одинаковые (prompt, image_input, aspect_ratio, resolution, output_format), достаточно поменять model на nano-banana-pro; главное, чтобы формат был среди 10 поддерживаемых в Pro.

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

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

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