Перейти к основному содержанию
Nano Banana — модель генерации изображений от Google с естественной обработкой языка и поддержкой длинных промптов до 20 000 символов.
Полная документация API: Генерация медиа

​
Обзор

ХарактеристикаЗначение
ТипГенерация изображений
ID моделиgoogle/gemini-2.5-flash-image
Max prompt20 000 символов
Соотношения сторон1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9
Форматы выводаpng, jpeg
Референс-изображениядо 8

​
Сценарии использования

Товарные фото

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

Рекламные креативы

Генерация баннеров и рекламных материалов

Иллюстрации

Создание уникальных иллюстраций для статей и презентаций

Социальные сети

Визуальный контент для постов и сторис

​
Пример запроса

Для генерации и редактирования изображений используйте Media API с параметром images: 
const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/gemini-2.5-flash-image',
    input: {
      prompt: 'Измени фон на закат над морем',
      aspect_ratio: '16:9',
      images: [
        { type: 'url', data: 'https://example.com/photo.jpg' }
      ]
    }
  })
});

const result = await response.json();
console.log(result);

​
Параметры

ПараметрТипОбязательныйОписание
modelstringДаID модели: google/gemini-2.5-flash-image
promptstringДаТекстовое описание желаемого изображения (до 20 000 символов)
nnumberНетКоличество изображений (по умолчанию 1, максимум 8)
aspect_ratiostringНетСоотношение сторон: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9
output_formatstringНетФормат вывода: png, jpeg
imagesarrayНетМассив референс-изображений для редактирования (до 8 шт.)

​
Пример запроса (cURL)

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash-image",
    "input": {
      "prompt": "Описание изображения",
      "aspect_ratio": "16:9",
      "images": []
    },
    "async": true
  }'

​
Советы и лучшие практики

Чем подробнее описание, тем точнее результат. Указывайте стиль, освещение, композицию, цветовую гамму.
Nano Banana отлично работает с промптами до 20 000 символов — описывайте сцену максимально подробно.
Выбирайте aspect_ratio в зависимости от цели: 1:1 для аватаров, 16:9 для баннеров, 9:16 для сторис.

​
Следующие шаги

Nano Banana Pro

Продвинутая версия с поддержкой разрешений до 4K

API Reference

Полная документация API