Что нового в API Nano Banana 2 на Emix.ai?

`nano-banana-2` принимает промпты до 20 000 символов, до 14 референсных изображений (общим объемом до 30 МБ в форматах JPEG/PNG/WebP), 14 соотношений сторон плюс `auto`, а также три уровня разрешения (`1K`, `2K`, `4K`) с сохранением в PNG или JPG. Всё это доступно через один запрос `POST https://api.emix.ai/api/v1/client/tasks`.

Чем Nano Banana 2 отличается от предыдущей версии Nano Banana?

Предыдущий ID модели — `nano-banana`, новый ID — `nano-banana-2`. Nano Banana 2 увеличивает лимит промпта до 20 000 символов, поддерживает до 14 референсных изображений, предлагает 14 вариантов соотношения сторон (включая `8:1`, `4:1` и `21:9`) и добавляет поддержку разрешения `4K`. См. таблицу параметров выше и полную документацию на docs.emix.ai/market/google/nanobanana2.

Сколько референсных изображений можно отправить за один запрос?

До 14 изображений через параметр `input.image_input` общим объемом до 30 МБ. Поддерживаемые форматы: JPEG, PNG и WebP.

Поддерживает ли Nano Banana 2 аудио или липсинк?

Нет. Nano Banana 2 — это модель для генерации изображений (по тексту и редактирования по референсу). Она не генерирует аудио или видео.

Какие разрешения и соотношения сторон доступны?

Параметр `input.resolution` принимает значения `1K`, `2K` или `4K` (по умолчанию `1K`). Параметр `input.aspect_ratio` поддерживает `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9` или `auto` (по умолчанию).

Какие форматы возвращает API?

`png` или `jpg`, задается через параметр `input.output_format` (по умолчанию `jpg`).

Где можно бесплатно протестировать Nano Banana 2 перед интеграцией?

Воспользуйтесь браузерным демо на emix.ai/models/nano-banana-2, а затем перейдите в полнофункциональный Playground по адресу emix.ai/playground/nano-banana-2. Каждое поле в Playground напрямую соответствует параметру API.

Как интегрировать API в мое приложение?

Отправьте `POST`-запрос на `https://api.emix.ai/api/v1/client/tasks` с заголовком `Authorization: Bearer YOUR_API_KEY` и JSON-телом, содержащим `model: "nano-banana-2"` и ваш объект `input`. API возвращает `data.taskId`; опрашивайте эндпоинт Get Task Details или укажите `callBackUrl`, чтобы получить результат через вебхук. Готовые примеры кода для cURL, Python и Node.js доступны в разделе 5.

Сколько это стоит?

Оплата за использование Nano Banana 2 списывается с баланса кредитов вашего аккаунта Emix.ai — ответ `402 insufficient credits` означает, что пришло время пополнить счет. Актуальные тарифы опубликованы на странице тарифов Emix.ai (emix.ai/pricing) и по адресу docs.emix.ai/market/google/nanobanana2.

Выполняется ли задача синхронно?

Нет — запрос сразу возвращает `taskId`. Запросите готовое изображение через единый эндпоинт Get Task Details или получите его на ваш вебхук `callBackUrl`.

README.md

API Nano Banana 2 — Генерация 4K-изображений с использованием до 14 референсов на Emix.ai

Q: Какие коды статуса необходимо обрабатывать?

`200` (успешно), `401` (не авторизован), `402` (недостаточно кредитов), `404` (не найдено), `422` (ошибка валидации), `429` (превышен лимит запросов), `433` (лимит суб-ключа), `455` (сервис недоступен), `500` (ошибка сервера), `501` (сбой генерации), `505` (функция отключена).

Запустите API Nano Banana 2 (Gemini 3.1 Flash Image) от Google на Emix.ai, чтобы преобразовать промпт и до 14 референсных изображений в качественные изображения формата PNG или JPG в 1K, 2K или 4K. Один эндпоинт, один Bearer-ключ, один асинхронный taskId. Протестируйте бесплатно в песочнице, а затем перенесите тот же запрос в продакшен. Уже доступно на Emix.ai. POST https://api.emix.ai/api/v1/client/tasks с моделью: "nano-banana-2". Полная документация: docs.emix.ai/market/google/nanobanana2.

Попробовать в песочнице Изучить документацию

Релиз и доступность API

API Nano Banana 2 уже доступен на Emix.ai. Nano Banana 2 — это новейшая модель Google для генерации и редактирования изображений, выпущенная как Gemini 3.1 Flash Image. Модель с идентификатором nano-banana-2 можно вызывать через единый эндпоинт задач Emix.ai с той же Bearer-авторизацией, тем же паттерном асинхронных задач и тем же процессом поллинга Get Task Details, что и остальной каталог Emix.ai — никаких отдельных SDK и листов ожидания.Если у вас уже есть API-ключ Emix.ai, вы можете начать вызывать nano-banana-2 уже сегодня — никаких изменений в интеграции не требуется.

Провайдер и ID модели

Провайдер: Google. ID модели: nano-banana-2.

Эндпоинт и авторизация

Эндпоинт: POST https://api.emix.ai/api/v1/client/tasks. Авторизация: Authorization: Bearer YOUR_API_KEY.

Обработка

Асинхронно — запрос возвращает taskId, результаты можно получить через эндпоинт Get Task Details или они автоматически отправляются на ваш вебхук callBackUrl.

Документация

docs.emix.ai/market/google/nanobanana2

Песочница

emix.ai/playground/nano-banana-2

Доступность

Уже доступно на Emix.ai. С текущими ключами Emix.ai можно вызывать модель nano-banana-2 прямо сейчас без изменений в интеграции.

Ключевые возможности API Nano Banana 2

API Nano Banana 2 на Emix.ai предоставляет полный доступ к возможностям генерации изображений модели через один POST-запрос. Все параметры ниже строго валидируются рабочим API.

Генерация изображений по тексту с возможностью редактирования по референсам

Передайте только input.prompt для чисто текстовой генерации или прикрепите до 14 референсных изображений через input.image_input для редактирования, переноса стиля, сохранения согласованности персонажей или создания композиций на основе нескольких референсов. Общий размер файлов референсов в форматах JPEG, PNG или WebP может достигать 30 МБ.

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

Параметр input.prompt вмещает до 20 000 символов — этого достаточно для подробного описания сцен, брендбуков или раскадровок без усечения текста.

14 соотношений сторон + auto

Выбирайте из 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 или auto (по умолчанию). Квадратные посты, вертикальные Reels, ультраширокие баннеры и панорамы — все они имеют полноценную поддержку.

Три уровня разрешения

Параметр input.resolution принимает значения 1K, 2K или 4K (по умолчанию 1K). Выбирайте 4K для печати, главных изображений (hero shots) и предметной съемки, а 1K — для миниатюр и быстрых итераций.

Вывод в форматах PNG или JPG

Параметр input.output_format принимает значения png или jpg (по умолчанию jpg). PNG — для рабочих процессов, где важна прозрачность, и ревью без потерь качества, а JPG — для итоговых файлов меньшего размера.

Изначально асинхронная архитектура с вебхуками

Отправьте задачу, мгновенно получите taskId и либо опрашивайте эндпоинт получения деталей задачи, либо задайте callBackUrl, чтобы Emix.ai отправил готовый результат на ваш сервер POST-запросом.

Предсказуемые коды ошибок

401 ошибка авторизации, 402 недостаточно кредитов, 422 ошибка валидации, 429 превышен лимит запросов, 433 лимит суб-ключа, 455 сервис недоступен, 500 ошибка сервера, 501 сбой генерации, 505 функция отключена — эти коды легко встроить в вашу логику ретраев.

Почему стоит выбрать Emix.ai для API Nano Banana 2

Один ключ, один эндпоинт, все модели

Единый маршрут https://api.emix.ai/api/v1/client/tasks работает как для Nano Banana 2, так и для всего остального каталога моделей Emix.ai. Чтобы сменить модель, достаточно изменить одну строку.

Асинхронные задачи и встроенные вебхуки

callBackUrl — это полноправный параметр. Никакого кода-прослойки и кастомных очередей.

Бесплатный Playground для итерации промптов

Настраивайте промпты, соотношение сторон, разрешение и референсы на emix.ai/playground/nano-banana-2 еще до того, как напишете хоть строчку кода — в API отправляются абсолютно те же параметры.

Прозрачная документация

Каждый параметр, каждый код статуса и каждый лимит опубликованы на docs.emix.ai/market/google/nanobanana2.

Биллинг на основе кредитов

Единый баланс аккаунта покрывает использование Nano Banana 2 и любых других моделей — никаких отдельных контрактов под каждую модель.

API Nano Banana 2 в сравнении с предыдущим поколением

Предыдущая версия Nano Banana на Emix.ai заложила основы воркфлоу с несколькими референсами. Nano Banana 2 расширяет набор поддерживаемых параметров API. Переход осуществляется изменением всего одной строчки кода: замените "model": "nano-banana" на "model": "nano-banana-2", и вы сразу сможете использовать увеличенное окно промпта, более широкий выбор соотношений сторон, генерацию в 4K и до 14 референсов.

Быстрый старт

Четыре шага от идеи до первого API-вызова в проде.

Шаг 1 — Онлайн-тест

Откройте страницу модели по адресу emix.ai/models/nano-banana-2 и запустите разовую генерацию прямо в браузере. Для демо-версии API-ключ не требуется.

Шаг 2 — Playground

Перейдите в Playground Nano Banana 2 (emix.ai/playground/nano-banana-2) для итеративной доработки промпта, aspect_ratio, resolution, output_format и референсных изображений на одном экране. Каждый элемент управления в Playground 1:1 соответствует одноименному полю в API.

Шаг 3 — Получите доступ к API

Создайте аккаунт или авторизуйтесь на Emix.ai, сгенерируйте API-ключ в панели управления и проверьте свой баланс. Этот ключ работает со всеми моделями в каталоге Emix.ai.

Шаг 4 — Отправьте свой первый запрос

Отправьте задачу с помощью nano-banana-2. API вернет taskId; опрашивайте эндпоинт Get Task Details или ожидайте вебхук callBackUrl.cURL:bash

curl -X POST https://api.emix.ai/api/v1/client/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "Comic poster: cool banana hero in shades leaps from a sci-fi launch pad",
      "image_input": [],
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

Python:python

import requests

resp = requests.post(
    "https://api.emix.ai/api/v1/client/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "nano-banana-2",
        "callBackUrl": "https://your-domain.com/api/callback",
        "input": {
            "prompt": "Editorial product shot of a ceramic mug on stone, soft window light",
            "image_input": [],
            "aspect_ratio": "4:5",
            "resolution": "4K",
            "output_format": "jpg",
        },
    },
)

task_id = resp.json()["data"]["taskId"]
print("taskId:", task_id)

Node.js:js

const res = await fetch("https://api.emix.ai/api/v1/client/tasks", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    callBackUrl: "https://your-domain.com/api/callback",
    input: {
      prompt: "Isometric icon set, 8 items, pastel palette, soft shadows",
      image_input: [],
      aspect_ratio: "1:1",
      resolution: "1K",
      output_format: "png",
    },
  }),
});

const { data } = await res.json();
console.log("taskId:", data.taskId);

При успешной отправке возвращается:json{ "code": 200, "msg": "success", "data": { "taskId": "string" } }Используйте полученный taskId в едином эндпоинте Get Task Details, чтобы получить готовое изображение.

Что можно создать с помощью API Nano Banana 2

Креативы для кампаний в фирменном стиле

Передайте логотип, фотографию модели и цветовой референс (до 14 изображений общим объемом до 30 МБ) и отправьте промпт Nano Banana 2, чтобы сгенерировать постеры в фирменном стиле в разрешении 4K.

Массовая генерация предметных фото

Используйте 4:5 или 1:1 в разрешении 2K–4K для каталогов и маркетплейсов; переключите output_format на png, когда вам нужен чистый готовый файл без альфа-канала для утверждения макета.

Vertical short-form creative

Формат 9:16 в разрешении 1K или 2K для рилс, шортс и сторис. Асинхронная генерация с доставкой через callBackUrl.

Ультраширокие главные баннеры и панорамы

Форматы 21:9, 8:1 и 4:1 идеально подходят для главных экранов лендингов, рекламных баннеров и кинематографичных кадров.

Единообразие персонажей и стиля на основе референсов

До 14 референсных изображений позволяют зафиксировать персонажа, окружение и освещение всего за один вызов.

Журнальные иллюстрации и комиксы

Лимит промпта в 20 000 символов отлично подходит для детальных покадровых сценариев и раскадровок.

Массовая генерация ассетов

Ставьте в очередь тысячи задач — вебхук callBackUrl уведомит ваш воркер хранилища сразу же, как только каждое изображение будет готово.

API Nano Banana 2

4.9/ 5

128 ratings

Tap a star to rate