3.1.1: Вітання та перша генерація

Час на виконання: 10 хвилин
Передумови: Файли Nano Banana завантажені (Модуль 3.0)

Почніть цей модуль в Claude Code: Запустіть /start-3-1-1.

Огляд

Модуль 3.1.1 доводить вас від нуля до вашого першого AI-генерованого зображення. Ви налаштуєте ключ Gemini API, конфігуруєте billing та побачите як Claude перетворює референсне фото у щось чудове.

Головний висновок: Налаштування — одноразовий процес. Після конфігурації ключа API ви можете генерувати зображення з простими запитами природною мовою.

Що таке Gemini 3 Pro?

Gemini 3 Pro (кодова назва "Nano Banana Pro") — найдосконаліша модель генерації зображень Google. Вона може:

Генерувати фотореалістичні зображення з текстових описів
Перетворювати референсні фото зберігаючи ідентичність
Додавати точні текстові накладення до зображень
Створювати послідовних персонажів через кілька генерацій
Розуміти та відтворювати складні візуальні стилі

На відміну від споживчих додатків, прямий доступ до API дає:

Більш дозвільні правила контенту (наприклад, реальні люди як референси)
Повний контроль параметрів (пропорція сторін, роздільна здатність тощо)
Ітерація на основі сесії (вдосконалення зображень крок за кроком)
Нижча вартість (~$0.10/зображення)

Налаштування вашого API-ключа

Крок 1: Отримайте ключ з Google AI Studio

Перейдіть до Google AI Studio
Увійдіть за допомогою вашого акаунта Google
Прийміть Умови надання послуг (якщо вперше)
Натисніть "Get API Key" на лівій бічній панелі
Натисніть "Create API key" для генерації нового ключа
Скопіюйте ключ — він починається з AIza...

Крок 2: Налаштування Billing

Gemini 3 Pro вимагає акаунт billing. Не хвилюйтесь — це оплата за використання та дуже доступна.

У Google AI Studio перейдіть до Get API key
У колонці "Quota tier" натисніть Set up billing
Дотримуйтесь підказок для додавання платіжного методу

Контекст вартості:

~$0.10 за генерацію зображення
Весь цей курс коштує менше $5 загалом

Крок 3: Налаштування вашого API-ключа

Просто скажіть Claude ваш API-ключ і він налаштує все:

"My Gemini API key is AIzaYourKeyHere - please add it to my .env file"

Claude створить файл .env та безпечно збереже ваш ключ.

Ваша перша генерація

Після завершення налаштування ви готові до генерації.

Що відбувається за кадром:

Ви описуєте що хочете
Claude викликає функцію generate() з image_gen.py
Функція відправляє ваш запит до API Gemini
Згенероване зображення зберігається у папку outputs/
Claude говорить вам де знайти його

Час генерації: Близько 10–15 секунд за зображення.

Структура виводу

Згенеровані зображення зберігаються у папку outputs/ у вашій директорії nano-banana:

nano-banana/
├── outputs/
│   ├── image_001.png
│   ├── image_002.png
│   └── ...
├── image_gen.py
├── .env
└── ...

Усунення несправностей

"API key not found" або помилки автентифікації

Перевірте що файл .env існує
Переконайтесь що ключ вставлено правильно без зайвих пробілів
Переконайтесь що ключ починається з AIza

Помилки "Billing not enabled"

Поверніться до Google AI Studio → Settings → Plan information
Підтвердіть що billing налаштований

Генерація не вдається або перевищує час очікування

Перевірте підключення до Інтернету
Gemini може мати велике навантаження — зачекайте хвилину і спробуйте знову

Що далі?

Модуль 3.1.2 навчає про функцію generate(), доступні параметри та як ітерувати ваші зображення.

Інтерактивний трек: Введіть /start-3-1-2

Про цей курс

Створено Carl Vellotti.