Nano Banana 2

Полный API-гайд по генерации изображений до 4K

Nano Banana 2

Nano Banana 2 (google/gemini-3.1-flash-image-preview) генерирует и редактирует изображения с поддержкой до 4K разрешения, точным рендерингом текста и возможностью передавать до 8 референс-изображений.

Характеристики

ХарактеристикаNano BananaNano Banana 2
ID моделиgoogle/gemini-2.5-flash-imagegoogle/gemini-3.1-flash-image-preview
Max prompt20 000 символов20 000 символов
Разрешениянет1K, 2K, 4K
Aspect ratio10 вариантов11 вариантов
Референс-изображениядо 8до 8

Параметры

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

Примеры

Генерация изображения

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "input": {
      "prompt": "Фотореалистичный портрет бизнесмена в современном офисе",
      "aspect_ratio": "1:1",
      "image_resolution": "2K",
      "output_format": "png"
    }
  }'

Редактирование с референс-изображением

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "input": {
      "prompt": "Добавь текст SALE 50% крупными буквами в центре",
      "image_resolution": "4K",
      "images": [
        { "type": "url", "data": "https://example.com/banner.jpg" }
      ]
    }
  }'

Ответ

API возвращает объект с ID задачи:

{
  "id": "aig_abc123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001244,
  "model": "google/gemini-3.1-flash-image-preview"
}

Опросите статус через GET /v1/media/{id}:

curl "https://api.usellm.ru/v1/media/aig_abc123" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

Статусы

СтатусОписание
pendingВ очереди
processingГенерация выполняется
completedГотово, URL результата в поле output.url
failedОшибка, описание в поле error

Результаты хранятся ограниченное время после генерации. Скачивайте файлы сразу после получения completed и храните у себя.

Советы