Nano Banana 2
Полный API-гайд по генерации изображений до 4K
Nano Banana 2
Nano Banana 2 (google/gemini-3.1-flash-image-preview) генерирует и редактирует изображения с поддержкой до 4K разрешения, точным рендерингом текста и возможностью передавать до 8 референс-изображений.
Характеристики
| Характеристика | Nano Banana | Nano Banana 2 |
|---|---|---|
| ID модели | google/gemini-2.5-flash-image | google/gemini-3.1-flash-image-preview |
| Max prompt | 20 000 символов | 20 000 символов |
| Разрешения | нет | 1K, 2K, 4K |
| Aspect ratio | 10 вариантов | 11 вариантов |
| Референс-изображения | до 8 | до 8 |
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
model | string | Да | google/gemini-3.1-flash-image-preview |
prompt | string | Да | Текстовое описание желаемого изображения (до 20 000 символов) |
aspect_ratio | string | Нет | Соотношение сторон: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto |
image_resolution | string | Нет | Разрешение: 1K, 2K, 4K |
output_format | string | Нет | Формат вывода: png, jpeg |
images | array | Нет | Массив референс-изображений для редактирования (до 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 и храните у себя.