Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · По умолчанию: auto |
enable_image_search | Нет | Сначала ищет настоящие фото места или товара. По умолчанию: false |
enable_web_search | Нет | Сначала проверяет в интернете даты, места и свежие факты. По умолчанию: false |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
output_format | Нет | Формат файла результата. png · jpeg · По умолчанию: png |
prompt | Да | Say what to change and what must stay the same. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 2k · 4k · По умолчанию: 1k |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| resolution 1K | 7,2 | 0,072 $ |
| resolution 2K | 10,8 | 0,11 $ |
| resolution 4K | 24,3 | 0,24 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 8 кредитов за изображение (0,08 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Nano Banana 2.1 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model google/nano-banana-2.1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2.1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "1k",
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Nano Banana 2.1
Сколько стоит API Nano Banana 2.1?
Nano Banana 2.1 стоит от 8 кредитов (0,08 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Цены по вариантам: 1K 7,2 кредита за изображение, 2K 10,8 кредита за изображение, 4K 24,3 кредита за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Nano Banana 2.1 в API?
Укажите google/nano-banana-2.1/text-to-image — Создать картинку; google/nano-banana-2.1/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Это действительно Nano Banana 2.1 от Google?
Да. Запросы обрабатывает модель, которую Google выпустила 6 октября 2026 года как Nano Banana 2.1 — обновление Nano Banana 2 (Gemini 3.1 Flash Image). Выходные размеры 1K, 2K и 4K совпадают с теми, что Google публикует для неё.
Nano Banana 2.1 или Nano Banana 2?
Новее 2.1: Google улучшила качество изображения, следование промпту, согласованность персонажей и отрисовку текста и заявляет, что устранила швы на широких баннерах в 2K и 4K. У Nano Banana 2 есть уровень черновика 0.5K, которого у 2.1 нет. Обе модели поддерживают веб-поиск, поиск изображений и до четырнадцати референсов. Google объявила Nano Banana 2 устаревшей (дата отключения не объявлена) и рекомендует перейти на 2.1.
Насколько хорошо она отрисовывает текст?
Каждая строка в кавычках получилась с написанием, как мы её задали: заголовок журнала с двумя строками на обложке, название фильма со строкой о премьере, неоновая вывеска мотеля и название альбома, нарисованное на пустом конверте при редактировании. Мелкий текст, который мы не прописывали, например мелкий текст под названием постера или штрихкод, вернулся заполнителем.
Какого размера изображения?
В соотношении 1:1 уровни дают квадраты со стороной 1024, 2048 и 4096 пикселей. Остальные форматы сохраняют примерно то же число пикселей: в наших тестах 3:4 в 1k вернулось 896 × 1200, 16:9 в 2k — 2752 × 1536, а баннер 8:1 в 2k — 5856 × 704.
Какие ограничения у API Nano Banana 2.1?
Разрешения: 1K · 2K · 4K; Соотношения сторон: auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 +9; Референсные изображения: 14; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Nano Banana 2.1 без кода?
Да. Playground запускает Nano Banana 2.1 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Nano Banana
Nano Banana Pro сначала продумывает композицию, а потом рисует, поэтому аккуратнее справляется с плотным текстом, схемами и многосоставными макетами. Nano Banana 2.1 новее, быстрее и обходится меньше чем вдвое дешевле за картинку, а ещё умеет баннеры 8:1 и поиск по сети и по картинкам.
- Nano Banana 2.1 APIНовейшая Nano Banana от Google: чёткий текст и вывод в 4KОт 8 кредитов за изображение
- Nano Banana Pro APIСначала продумывает макет: плотный текст, схемы и правки в 4KОт 17 кредитов за изображение
- Nano Banana 2 APIБыстрые картинки Gemini до 4K, до 14 референсовОт 6 кредитов за изображение

