Обзор Yes Ai API нейросети Nano Banana PRO

Nano Banana Pro — это современная нейросеть от Google, появившаяся в 2025 году. Она умеет не только создавать изображения по текстовым описаниям, но и обрабатывать уже готовые фотографии. Благодаря Yes Ai API, вы легко внедрите эту технологию в свои проекты: будь то Telegram-бот, мобильное приложение или сайт.

Возможности у Nano Banana и её продвинутой версии действительно впечатляют:

Работа с промптами на любом языке — русский, английский, хоть японский.
Автоматическая корректировка промптов: если описание не совсем точное, нейросеть сама подправит его для лучшего результата.
Генерация и редактирование текста прямо на изображениях.
Глубокая модификация фотографий: можно менять стиль, корректировать детали, добавлять или убирать объекты и персонажей.
Анализ содержимого снимка перед началом обработки — чтобы результат был максимально релевантным.

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

Для быстрой проверки возможностей Nano Banana советую воспользоваться нашим Telegram-ботом. Там можно наглядно посмотреть, как работает генерация и редактирование изображений.

При работе с API Nano Banana вы сами выбираете параметры генерации:

Соотношение сторон итогового изображения.
Версия нейросети: стандартная или Pro.
Промпт на любом удобном языке.
[Опционально] Список референсов — ссылки на изображения, которые хотите использовать как основу для модификации.

Важные ограничения

Создавать NSFW-контент через Nano Banana запрещено. Для контроля за этим в каждом запросе нужно указывать параметр ‘customer_id’ — уникальный идентификатор пользователя. Это помогает системе Yes Ai отслеживать нарушителей и блокировать их, не затрагивая ваш API-токен.

В Yes Ai для работы с нейросетью Nano Banana используется внутренняя валюта — 🔅 монеты. Именно ими оплачиваются все генерации.

Актуальные цены всегда можно посмотреть в прайс-листе (ссылка на документ).

Цена одной монеты зависит от того, сколько вы покупаете за раз. Минимальная стоимость — 70 копеек (примерно $0.008), максимальная — 1 рубль (около $0.012).
Чем больше монет в заказе, тем выгоднее цена: при крупных покупках скидка доходит до 30%. Разовый пакет — от 300 до 5000 монет.

Покупка монет происходит через Telegram-бота @yes_ai_bot. Просто отправьте ему команду /tariffs — и следуйте инструкциям. Все финансовые операции проходят только через этого бота.

Если планируете интегрировать Nano Banana PRO в свой сервис или проект и нужен большой объем генераций с максимальной скидкой, напишите в поддержку @yes_ai_support. Кратко расскажите о задаче и получите индивидуальные условия.

Чтобы начать работу с API Yes Ai, понадобится токен. Получить его можно, следуя инструкции на сайте.

В Nano Banana доступны два режима генерации:

генерация по промпту без референсов (промпт можно писать на любом языке);
генерация по промпту с одним или несколькими референсами (до 10 изображений).

Если используете референсы (оригинальные фото), система автоматически обрежет их под выбранное соотношение сторон. Если пропорции исходника не совпадают с параметром 'dimensions', сервис возьмёт центральную часть изображения и подгонит её под нужные размеры.

Хотите добавить текст на картинку? Просто укажите его в промпте в экранированных кавычках.

POST https://api.yesai.su/v2/google/nanobanana/generations
headers: { Content-Type: application/json, Authorization: Bearer }

Так выглядит запрос:

curl -X POST https://api.yesai.su/v2/google/nanobanana/generations -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{ "version":"v.1.pro", "prompt": "текст вашего промпта на любом языке. если на изображение нужно добавить текст, то его нужно обрамлять /"двойными кавычками/" с экранированием", "style":"2,3", "dimensions":"16:9", "references_urls":["https://yoururl.com/image1.jpeg","https://yoururl.com/image2.jpeg","https://yoururl.com/image3.jpeg"], "customer_id":"1a2b3c4d" }'

Параметры:

style = '', '0', '1' или '2,3,4' ((integer|string) — задаёт визуальное оформление. Можно выбрать из списка: 0 — без стиля, 1 — случайный, 2 — Midjourney, 3 — Steampunk, 4 — Cyberpunk, 5 — Аниме, 6 — Логотип, 7 — Фото, 8 — Картинка, 9 — Кино, 10 — Иллюстрация, 11 — Хоррор, 12 — Детализация, 13 — Космос, 14 — Готика, 15 — Сюрреализм, 16 — Реализм, 17 — Фэнтези, 18 — Научная фантастика, 19 — FantasyArt, 20 — Комикс, 21 — Пиксель-арт, 22 — 3D, 23 — Линейный рисунок, 24 — Оригами, 25 — Изометрия, 26 — Неонпанк, 27 — PrimeAnime, 28 — Акварель, 29 — Поп-арт, 30 — Кавай, 31 — Минимализм, 32 — Ретрофутуризм, 33 — Антиутопия, 34 — Реклама, 35 — Ренессанс, 36 — Биомеханика, 37 — Футуризм, 38 — Ар-деко, 39 — Кубизм, 40 — Мода, 41 — RPG, 42 — Диско, 43 — Архитектура, 44 — Люкс, 45 — Кибернетика, 46 — РетроКибер, 47 — БиоКибер, 48 — Сказка, 49 — Пин-ап, 50 — Сдвиг цвета. По умолчанию — 0.
prompt = '' ((string) — текстовое описание задания. Минимум 3 символа, максимум 10 000.
customer_id = '' ((string) — уникальный идентификатор пользователя (от 1 до 50 символов). Используется для контроля доступа и блокировки нарушителей, например, при попытке создать NSFW-контент.
version = 'v.1.pro' ((string) — версия нейросети. По умолчанию 'v.1.pro'. Можно выбрать 'v.1' или 'v.1.pro'.
dimensions = '16:9' ((string) — формат изображения. По умолчанию '16:9'. Доступны также '9:16' и '16:9'.
references_urls = [] ((array) — список ссылок на референсные изображения. Можно добавить от 1 до 10 ссылок.

Важный момент: переменная "customer_id" обязательна для заполнения. Это уникальный идентификатор пользователя, который оформил задание в вашей системе. В роли customer_id отлично подойдет Telegram ID, если заявка поступила через бота в Telegram, либо уникальный номер клиента из вашей базы данных. Если пользователь нарушит правила работы с нейросетями, его ID временно блокируется. При этом ваш API-токен Yes Ai продолжает работать без ограничений.

Дополнительно можно указать ссылки на изображения в массиве 'references_urls'. Нейросеть будет использовать их как ориентиры при создании новых картинок. Поддерживаются форматы: jpg, jpeg, png.

Возможные ошибоки:

['success' => false, 'message' => 'STYLE_IS_EMPTY'], 400
['success' => false, 'message' => 'STYLE_NOT_VALID'], 400
['success' => false, 'message' => 'PROMPT_IS_EMPTY'], 400
['success' => false, 'message' => 'PROMPT_NOT_VALID'], 400
['success' => false, 'message' => 'CUSTOMER_ID_IS_EMPTY'], 400
['success' => false, 'message' => 'CUSTOMER_ID_NOT_VALID'], 400
['success' => false, 'message' => 'VERSION_IS_EMPTY'], 400
['success' => false, 'message' => 'VERSION_NOT_VALID'], 400
['success' => false, 'message' => 'DIMENSIONS_IS_EMPTY'], 400
['success' => false, 'message' => 'DIMENSIONS_NOT_VALID'], 400
['success' => false, 'message' => 'REFERENCES_URLS_IS_EMPTY'], 400
['success' => false, 'message' => 'REFERENCES_URLS_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'VERSION_NOT_FOUND'], 404
['success' => false, 'message' => 'DIMENSIONS_NOT_FOUND'], 404
['success' => false, 'message' => 'USER_HAS_BEEN_BANNED'], 409
['success' => false, 'message' => 'USER_HAS_BEEN_DELETED'], 409
['success' => false, 'message' => 'NOT_ENOUGH_RPOINTS'], 409
['success' => false, 'message' => 'PROMPT_NSFW_WORDS'], 409
['success' => false, 'message' => 'PROMPT_EN_NSFW_WORDS'], 409
['success' => false, 'message' => 'STYLE_LIMIT_EXCEEDED'], 409
['success' => false, 'message' => 'TASK_LIMIT_EXCEEDED'], 409
['success' => false, 'message' => 'TASK_IS_NOT_COMPLETED'], 409
['success' => false, 'message' => 'MODIFICATION_FORBIDDEN'], 409
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500

Если задание отправлено успешно, система вернет такой ответ:

['success' => true, 'message' => 'OK', 'results' => ['generation_data' => [ ... ]]], 200

В ответе вы найдете уникальный идентификатор задания — {id}. С его помощью легко узнать, на каком этапе обработка, а также получить ссылки на готовые изображения.

Nano Banana работает быстро. Как только отправили задание, уже через 15–20 секунд можно узнать, что происходит с вашей генерацией. Дальше — обновляйте статус каждые 10 секунд, чтобы не пропустить готовый результат.

В среднем одно изображение нейросеть создает за 20–40 секунд. Это удобно: не нужно долго ждать, чтобы получить результат и сразу приступить к следующей задаче.

GET https://api.yesai.su/v2/google/nanobanana/generations/{id}
headers: { Content-Type: application/json, Authorization: Bearer }

Запрос для проверки статуса задачи по её ID:

curl -X GET https://api.yesai.su/v2/google/nanobanana/generations/{id} -H "Authorization: Bearer <token>" -H "Content-Type: application/json"

Параметры:

{id} = 12345 — уникальный идентификатор задания (обязательное поле).

Ответ при успехе:

['success' => true, 'message' => 'OK', 'results' => ['generations_data' => [ ... ]]], HTTP 200

Возможные статусы задания:

"status": 0 ("status_description":"in queue") — задание стоит в очереди, просто ждём.
"status": 1 ("status_description":"in progress") — обработка уже началась, остаётся подождать.
"status": 2 ("status_description":"completed") — задача завершена, ссылка на результат доступна в 'result_url'.
"status": 3 ("status_description":"rejected with error") — выполнение не удалось, ищите причину в "comment_ru" или "comment_en".
"status": 4 ("status_description":"rejected due to timeout") — время ожидания вышло, отправьте задание заново.

Вот как выглядит пример ответа, когда запрашиваешь статус задания по его ID:

{ "success": true, // данные успешно получены "message": "OK", "results": { "generation_data": { "id": 137, // id задания "user_id": 1234567890, // id пользователя, подавшего задание "tariff_id": 30, // id тарифа пользователя, подавшего задание, 30 - VIP "model_id": 1, "type": 53, "styles": [ 2, 3, 7 ], "settings": { "customer_id": "abc123", "dimensions": "16:9", "model_alias": "nano_banana", "references_urls": [ "https://yoururl.com/image1.jpeg", "https://yoururl.com/image2.jpeg", "https://yoururl.com/image3.jpeg" ], "version": "v.1.pro" }, "child_ids": [], "parent_id": 0, "result_url": "https://yesai.su/files/google/nanobanana/generations/1234567890_1764308335506168.png", // ссылка на скачивание результата генерации "result_type": "image", "result_data": { "image_width": 1365, // ширина сгенерированного изображения в пикселях "image_height": 768, // высота сгенерированного изображения в пикселях "image_mime_type": "image/png" }, "comment_ru": "", // комментарий к заданию на русском языке, будет заполнен только при ошибке генерации со статуосм 3 "comment_en": "", // комментарий к заданию на английском языке, будет заполнен только при ошибке генерации со статуосм 3 "accounting": { "total_cost": 2, "spent_points": 0, "spent_rpoints": 0, // стоимость генерации изображения в монетах, в данном случае равна нулю, так как в этом примере она была сделана за счет монет, списанных с 'regenerating_rpoints' из VIP-пакета "spent_repost_points": 0, "spent_regenerating_rpoints": 2, // стоимость генерации этого изображения в монетах, все генерации в Nano Banana оцениваются в монетах "spent_balance": 0, "spent_rbalance": 0, "remaining_points": 1820, "remaining_rpoints": 2495.6001515, // остаток монет на основном балансе заказчика в помент выполнения задания "remaining_repost_points": 3, "remaining_regenerating_rpoints": 70.54265, // остаток монет на восстанавливающемся балансе из пакета VIP у заказчика в момент выполнения задания "remaining_balance": 0, "remaining_rbalance": 40272.93431 }, "language": "", "prompt": "смешай эти картинки", "prompt_en": "", "prompt_language": "", "status": 2, // статус задания, 2 - успешное выполнение генерации "status_description": "completed", // текстовое описание статуса задания "start_at": 1764308333, // время начала выполнения задания в формате Unixtime "finish_at": 1764308335, // время завершения выполнения задания в формате Unixtime "created_at": 1764308294, // время подачи задания в формате Unixtime "updated_at": 1764308335, "deleted_at": 0 } } }

Когда вы запускаете генерацию изображений через API нейросети Nano Banana, на выходе получаете уникальные ссылки для скачивания файлов в форматах PNG или JPG. Эти изображения хранятся на нашем сервере ровно 60 минут — не откладывайте, сразу скачивайте нужные картинки на свой сервер или облако.

Если вы используете версию Nano Banana Pro ("version":"v.1.pro"), после генерации доступна функция апскейла — увеличения разрешения и детализации до 2K или 4K. Для этого понадобится номер задания {id}, который возвращается в JSON-ответе после генерации ("id").

Технические детали и примеры работы метода апскейла мы опубликуем позже в отдельной инструкции.

Если возникнут вопросы или потребуется помощь, пишите в Telegram: @yes_ai_support. Мы всегда на связи.

Форум по нейросетям

Обзор Yes Ai API нейросети Nano Banana PRO

Что умеет нейросеть Nano Banana Pro

Сколько стоит генерация в нейросети Nano Banana

Отправка заданий через API Nano Banana

Проверяем статус генерации через API Nano Banana

Разбираем JSON-ответ от API по задаче генерации изображения в нейросети Nano Banana

Как работает обработка заданий Nano Banana Pro через API Yes Ai

Апскейл в Nano Banana Pro