| name | nano-banana |
| description | Генерация изображений через Nano Banana (LaoZhang API / Gemini 3 Pro Image) — от простых картинок до фотореалистичных портретов и персонажей. |
| $ARGUMENTS | Описание желаемого изображения, тип (портрет/сцена/thumbnail/identity-kit), или команда |
Nano Banana — AI Генерация Изображений
Мастер-система для создания изображений через LaoZhang API (Gemini 3 Pro Image): от простых картинок до фотореалистичных портретов и постоянных персонажей.
Движок: Gemini 3 Pro Image через LaoZhang API
Принцип: Специфика побеждает неопределённость. Описание сцены > список ключевых слов.
Быстрый старт
"Создай картинку: предприниматель в офисе"
"Создай фотореалистичный портрет 25-летней девушки"
"Замени лицо на моё" + [прикрепить фото]
Философия: Один раз зафиксировать → Бесконечно использовать
API — LaoZhang + Gemini 3 Pro Image
Endpoint
POST https://api.laozhang.ai/v1beta/models/gemini-3-pro-image-preview:generateContent
Authorization: Bearer $API_KEY
Параметры изображения
| Параметр | Значения | Описание |
|---|
aspectRatio | "1:1", "3:4", "4:3", "9:16", "16:9" | Соотношение сторон |
imageSize | "1K", "2K", "4K" | Разрешение (4K = лучшее) |
responseModalities | ["IMAGE"] | Тип ответа |
Разрешения по формату
| Формат | 4K разрешение | Когда использовать |
|---|
| 16:9 | 5504×3072 | Баннеры, YouTube обложки |
| 3:4 | 2880×3840 | Портреты, карусели |
| 9:16 | 3072×5504 | Stories, Reels обложки |
| 1:1 | 4096×4096 | Instagram посты, аватары |
| 4:3 | 3840×2880 | Горизонтальные фото |
Минимальный запрос
curl -X POST "https://api.laozhang.ai/v1beta/models/gemini-3-pro-image-preview:generateContent" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "ПРОМПТ"}]}],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "4K"
}
}
}'
С референсным изображением
{
"contents": [{
"parts": [
{
"inline_data": {
"mime_type": "image/png",
"data": "BASE64_ENCODED_IMAGE"
}
},
{"text": "ПРОМПТ с [image1] референсом"}
]
}],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "3:4",
"imageSize": "4K"
}
}
}
Таймауты и лимиты
| Размер | Время генерации | Рекомендуемый таймаут |
|---|
| 2K | 25-45 сек | 120 сек |
| 4K | 40-70 сек | 180 сек |
⚠️ НЕ убивать процесс раньше 180 секунд!
Примеры использования
Фотореалистичный портрет
Создай портрет 32-летней женщины, натуральная текстура кожи с видимыми порами,
снято на 85mm f/1.8 с освещением Рембрандта
Face Swap
Замени мужчину с [Image1] на человека с [Image2], сохранив черты лица и стиль оригинала
UGC-контент
Создай девушку 23 лет для UGC, снимает видео на телефон в кафе, естественное освещение
Обложка YouTube
Создай яркую обложку в стиле МрБиста с удивлённым лицом и жёлтыми стрелками
Workflow
1. Базовая генерация
- Промпт — описательный абзац (не список слов)
- Указание камеры и объектива для реализма
- Детали освещения и композиции
- Формат и разрешение через API параметры
2. Face Swap / Identity Kit
- Референсное фото через inline_data (base64)
- Точное указание что заменить
- Identity Lock блок для сохранения лица
- Сохранение оригинальной атмосферы
3. Создание персонажа (Identity Kit)
- Фиксация внешности в референсах
- Создание набора поз и ракурсов
- Использование для всех последующих генераций
- Подробнее →
nano-banana-identity-kit.md
4. Пост-продакшн
- Upscaling — запрос с imageSize "4K"
- Редактирование — отправить изображение + промпт с изменениями
- Мульти-image композиция — несколько inline_data в одном запросе
Файлы
| Файл | Содержание |
|---|
nano-banana-examples.md | Примеры трансформации идей в промпты |
nano-banana-realism.md | Техники фотореализма |
nano-banana-identity-kit.md | Создание постоянных персонажей |
nano-banana-thumbnails.md | Обложки в стиле YouTube |
nano-banana-ideas.md | Креативные идеи и концепты |
nano-banana-vocabulary.md | Словарь терминов и техник |
Частые ошибки
❌ Список ключевых слов — "woman, portrait, realistic"
❌ Слишком общие описания — "красивая девушка"
❌ Игнорирование освещения — свет решает всё
❌ Без указания камеры — для реализма нужны технические детали
❌ Размытое лицо при face swap — нужен качественный референс
❌ Plastic skin эффект — добавить поры и несовершенства
❌ Inconsistent персонаж — не используется Identity Kit
❌ Таймаут < 120 сек — генерация 4K занимает до 70 секунд
❌ Без imageConfig — изображение будет низкого качества
Техника трёхслойного реализма
Layer 1: Камера и объектив
"Shot on Sony A7R IV with 85mm f/1.4 lens, 1/250 shutter, ISO 400"
Layer 2: Освещение и композиция
"Rembrandt lighting, shallow depth of field, soft natural light from window"
Layer 3: Детали и несовершенства
"Natural skin texture with visible pores, fine lines, no airbrushing, unretouched look"
Face Swap формула
Replace [КОГО] from [Image1] with [КОГО] from [Image2].
Preserve facial features, body type, and clothing so they look like themselves.
They should organically fit into the atmosphere of [Image1].
Identity Kit процесс
- Концепция — возраст, этничность, стиль
- Референсы — 3-5 фото разных ракурсов (4K, f/8, всё в фокусе)
- Тестирование — проверка консистентности
- Использование — промпты с референсом через inline_data
Identity Lock блок (вставлять в промпт)
IDENTITY LOCK for person from [Image1]:
- Preserve EXACT facial features: bone structure, nose shape, eye spacing, jawline
- Preserve EXACT skin tone, texture, pores, and blemishes
- Preserve EXACT hairstyle, hair color, and hairline
- NO beautification, NO smoothing, NO idealization
- NO age change, NO ethnicity drift, NO face morphing
- The person MUST be 100% recognizable as the same individual
UGC-модели (E-модели)
Критерии качественной UGC-модели:
- Возраст 20-28 лет
- Естественная внешность (не модельная)
- Дружелюбное выражение лица
- Релевантная одежда для ниши
- Естественное освещение
- Believable ситуация
Применение: реклама, тестимониалы, демонстрация товаров, создание доверия.
Технические хаки
| Проблема | Решение |
|---|
| Размытое лицо | sharp focus, high detail, 85mm lens |
| Plastic skin | visible pores, natural skin texture, unretouched |
| Плохое освещение | Указать тип: Rembrandt, golden hour, soft window light |
| Неестественная поза | candid moment, natural expression, relaxed pose |
| Низкое качество | imageSize: "4K", камера в промпте |
| Руки размыты | Использовать f/5.6-f/8 в промпте |
| Лицо "плывёт" | Усилить Identity Lock + больше референсов |
| Rate limit (429) | Подождать 30 сек |
| Таймаут | Увеличить до 180+ сек |
Identity Kit пути (проекты)
| Проект | Путь к аватарам |
|---|
| Макс Галсон | {openclaw-path}/{project}/avatars/max/ |
| Dr. Stoyanov | {openclaw-path}/projects/36hour/avatars/stoyanov/ |
Python Template
import base64, json, requests
def generate_image(prompt, references=None, aspect_ratio="16:9", size="4K", api_key=None):
url = "https://api.laozhang.ai/v1beta/models/gemini-3-pro-image-preview:generateContent"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
parts = []
if references:
for ref_path in references:
with open(ref_path, "rb") as f:
b64 = base64.b64encode(f.read()).decode()
parts.append({"inline_data": {"mime_type": "image/png", "data": b64}})
parts.append({"text": prompt})
payload = {
"contents": [{"parts": parts}],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {"aspectRatio": aspect_ratio, "imageSize": size}
}
}
resp = requests.post(url, headers=headers, json=payload, timeout=180)
resp.raise_for_status()
data = resp.json()
for part in data.get("candidates", [{}])[0].get("content", {}).get("parts", []):
if "inline_data" in part:
return base64.b64decode(part["inline_data"]["data"])
return None
Bash Quick Commands
./laozhang-image.sh "промпт" --pro --ratio 16:9 --4k --output result.png
./laozhang-image.sh "промпт с [image1]" --ref reference.png --pro --4k
