Посібник Series Lab

Покроковий посібник простими словами: етапи 1–7, швидкий старт за $0, страховка, словник і часті запитання.

Що таке Series Lab

Series Lab — майстерня на вашому комп'ютері для створення серії картинок (наприклад, NFT-колекції) з одним упізнаваним персонажем чи стилем.

Ви задаєте базову картинку й набір рис (волосся, одяг, фон…). Майстерня складає для кожного NFT унікальний «рецепт», ШІ малює картинки, ви відбираєте кращі й пакуєте все для публікації.

Швидкий старт за 10 хвилин і $0

Пройдіть увесь шлях на демо-двигуні mock — без ключів і без оплати. Так ви зрозумієте, як усе працює, перш ніж витрачати гроші.

Запустіть майстерню: подвійний клік на start-lab.bat (або npm start). Відкриється http://127.0.0.1:5344/studio/.
1 · Огляд: назва «Test», ID test, кількість 12 → «Зберегти пресет».
2 · Основа: завантажте будь-яку картинку з роллю «Головна базова».
3 · Конструктор: оберіть пак pfp-core → «Застосувати пак» → «Зберегти промпт+трейти».
4 · Рецепти: «Зібрати архів».
5 · Генерація: двигун mock → «Пілот N» = 5 → «Порахувати» → «Згенерувати». Ви отримаєте 5 демо-картинок.
6 · Відбір: позначте ✓ / ↻ і спробуйте «Перегенерувати відхилені» — з'являться версії v·2.
7 · Експорт: «Run checklist» і «Build ZIP» — готовий пакет для маркетплейсу.

Mock малює прості кольорові заглушки, а не справжні портрети — це тренажер. Для справжніх картинок оберіть локальний або хмарний двигун.

Покроковий путівник

Кожен етап — окрема вкладка вгорі. Ідіть зліва направо: 1 → 7. Повертатися назад можна будь-коли — нічого не зламається.

1 · Огляд — паспорт серії

Навіщо: Задає ім'я серії, скільки буде NFT і «зерно» випадковості, щоб результат можна було повторити.

Що робити

Впишіть назву колекції та ID латиницею (напр. my-heroes).
Вкажіть кількість NFT — для першої спроби 12–24.
Seed можна лишити як є. Запам'ятайте: той самий seed = ті самі персонажі.
Оберіть двигун (можна змінити пізніше) і натисніть «Зберегти пресет».

Що отримаєте: Файл presets/<ID>.json — налаштування вашої серії.

Типові помилки

ID з пробілами чи кирилицею — використовуйте латиницю, цифри й дефіс.
Змінили seed після відбору — рецепти перерахуються, і картинки перестануть відповідати номерам. Міняйте seed лише на початку.

2 · Основа — обличчя серії

Навіщо: Базова картинка — зразок, на який схожі всі NFT. Від неї залежить упізнаваність персонажа.

Що робити

Завантажте свою картинку (роль «Головна базова») або згенеруйте кандидата з опису.
Перегляньте галерею input/ і призначте найкращу «Головною базовою».
За бажанням натисніть 🤖 Vision Assist, щоб отримати опис стилю для Конструктора.

Що отримаєте: Файл input/primary.png — головна базова картинка.

Типові помилки

Картинка з написами, логотипами чи складним фоном — ШІ копіюватиме ці дефекти.
Кілька людей у кадрі — серія вийде непослідовною.

3 · Конструктор — формула опису

Навіщо: Визначає, що в картинках однакове (keep, стиль), а що змінюється (риси).

Що робити

Застосуйте готовий пак рис або завантажте пресет.
Позначте 3–6 категорій, які мають змінюватися.
Перевірте опції: value, weight (частота), prompt (англійські слова).
Допишіть keep і suffix, за бажанням — Style lock. Натисніть Validate і «Зберегти промпт+трейти».

Що отримаєте: Пресет з повним словником рис і шаблоном промпту.

Типові помилки

Занадто багато змінних категорій — картинки стають хаотичними, персонаж губиться.
Порожній prompt в опції — ШІ не знатиме, що малювати для цього варіанту.

4 · Рецепти — план кожного NFT

Навіщо: Перетворює налаштування на точний список: NFT №1 — такі риси й такий опис, №2 — інші тощо.

Що робити

Натисніть «Зібрати архів».
Перегляньте таблицю, звіт рідкості та попередження про двійників.
За потреби відредагуйте окремий рецепт (клік по рядку).

Що отримаєте: Архів out/<ID>.json з усіма рецептами.

Типові помилки

Змінили пресет, але не зібрали архів знову — Генерація бере старі рецепти.

5 · Генерація — малюємо

Навіщо: ШІ малює картинки за рецептами. Це єдиний етап, де можуть витрачатися гроші.

Що робити

Оберіть двигун і силу референсу.
Оберіть «Пілот N» = 3–5.
Натисніть «Порахувати (безкоштовно)» і перевірте ціну та денну межу.
Натисніть «Згенерувати» і стежте за прогресом.

Що отримаєте: Папка out/<двигун>-s<сила>/ з картинками 1.png, 2.png… Попередні варіанти — у versions/.

Типові помилки

Одразу вся серія без пілоту — ризик заплатити за сотні невдалих картинок.
Немає ключа для обраного хмарного двигуна — див. вкладку «Ресурси».

6 · Відбір — обираємо кращі

Навіщо: Не кожна картинка вдала. Тут ви вирішуєте, що піде в колекцію.

Що робити

Оберіть набір, пройдіть усі картинки й поставте ✓ або ↻.
Переробіть відхилені — старі варіанти лишаться як версії (позначка v·N).
У вікні версій оберіть кращу — «Зробити поточною».

Що отримаєте: Позначки (marks.json) і фінальні поточні версії картинок.

Типові помилки

Пропущені картинки без позначки — скористайтеся фільтром «Без позначки».

7 · Експорт — пакуємо для випуску

Навіщо: Готує файли у форматі маркетплейсу. Продаж і мінт ви робите самі на сайті маркетплейсу.

Що робити

Запустіть NFT checklist і виправте зауваження.
Оберіть набір, формат і «Лише позначені keep» → «Build ZIP».
За бажанням: IPFS (Pinata), Provenance Hash, Showcase, LoRA-датасет.

Що отримаєте: ZIP з картинками й метаданими, готовий до завантаження на маркетплейс.

Типові помилки

Експорт без відбору — у колекцію потраплять невдалі картинки. Вмикайте «Лише позначені keep».

💰 Ресурси — ключі, гроші, кошик

Навіщо: Показує, які двигуни доступні, скільки витрачено й що лежить у кошику.

Що робити

Перевірте, які ключі «є» і які двигуни відповідають (⚡ Перевірити всі підключення).
Задайте денну межу витрат у .env: SERIES_SPEND_CAP_USD=5.
Відновіть випадково видалене з 🗑️ Кошика.

Що отримаєте: Контроль над витратами й файлами.

Типові помилки

Змінили .env, але не перезапустили майстерню — нові ключі не підхопляться.

Страховка: як майстерня береже ваші гроші й файли

Ці механізми працюють автоматично — вмикати нічого не треба (крім денної межі).

Версії: перегенерація ніколи не затирає оплачену картинку. Усі варіанти зберігаються, поточну можна змінити у Відборі (позначка v·N).
Кошик: видалення й заміна файлів переносять їх у out/trash/. Відновити можна у вкладці «Ресурси».
Денна межа витрат: SERIES_SPEND_CAP_USD у .env блокує запуск, який перевищить межу, ще до звернення до платного сервісу.
Журнал витрат: кожен платний виклик записується в out/render-log.jsonl (дата, двигун, ціна, успіх чи помилка).
Автостоп: якщо двигун 5 разів поспіль повертає помилку, пакет зупиняється (SERIES_MAX_CONSECUTIVE_FAILURES).
Оцінка перед запуском: «Згенерувати» доступна лише після безкоштовного «Порахувати».
Лише ваш ПК: майстерня працює на 127.0.0.1 і відхиляє запити з інших сайтів. Ключі не потрапляють у браузер.
Бренд-фільтр: промпти з назвами брендів, франшиз і знаменитостей блокуються до генерації.

Як працювати безкоштовно ($0)

Гроші потрібні лише хмарним двигунам. Усе інше працює без оплати.

Етапи 1–4, 6 і 7 завжди безкоштовні: вони працюють на вашому ПК.
Двигун mock — демо-картинки без ключів і без інтернету. Ідеально для навчання.
ComfyUI (порт 8188) або Automatic1111 (порт 7860) — справжні картинки на вашій відеокарті без оплати. Встановіть програму й модель SDXL чи Flux, запустіть її, потім оберіть двигун у майстерні.
Власні базові картинки завантажуються безкоштовно; Vision Assist без ключа робить простий безкоштовний аналіз.
Triage «Швидка евристика» безкоштовний; «AI Vision» — платний.

Словник термінів

Коротко і простими словами.

Пресет: файл налаштувань серії: назва, кількість, seed, риси, шаблон опису.
Seed (зерно): слово чи число, що фіксує випадковість. Той самий seed = той самий набір персонажів.
Базова картинка: зразок, на який схожі всі NFT серії. Головна базова = primary.
Риса (трейт): характеристика, що змінюється: волосся, очі, одяг, фон.
Опція: конкретний варіант риси, напр. «руде волосся».
Вага (weight): наскільки часто трапляється опція. Вага 10 — удесятеро частіше, ніж вага 1.
Пак рис: готовий набір рис і опцій з бібліотеки libraries/traits/.
Промпт: текстовий опис картинки англійською, за яким ШІ малює.
keep: фрази, що є в кожному промпті (незмінна частина).
suffix: кінцівка промпту: якість, заборони («no text»).
Style lock: фіксатори ракурсу, світла, настрою й кадру.
Рецепт: план одного NFT: набір рис + готовий промпт.
DNA: короткий відбиток набору рис. Однакова DNA = двійники.
Архів: файл з усіма рецептами серії (out/<ID>.json).
Двигун: сервіс чи програма, що малює картинки (fal.ai, ComfyUI, mock…).
Сила референсу: наскільки картинка тримається бази: 0.1 вільно, 0.95 майже копія.
Пілот: пробна генерація кількох картинок перед усією серією.
Набір: папка з картинками одного запуску, напр. out/fal-s0.45/.
Версія: один із варіантів картинки для того самого номера. Поточна йде в галерею та експорт.
Кошик: out/trash/: видалені й замінені файли, які можна відновити.
Денна межа витрат: максимум доларів на день (SERIES_SPEND_CAP_USD).
Triage: автоматична оцінка якості картинок з порадою ✓ чи ↻.
Upscale: збільшення роздільної здатності картинки.
Метадані: JSON-опис NFT: назва, картинка, риси. Маркетплейс читає саме його.
IPFS: децентралізоване сховище файлів; Pinata — сервіс для завантаження туди.
Provenance Hash: відбиток колекції, що доводить незмінність картинок.
LoRA: невелике донавчання моделі ШІ на ваших картинках, щоб вона малювала вашого персонажа.
Мінт: створення NFT у блокчейні. Майстерня його не робить — лише готує файли.
Лаунчпад: сервіс для запуску продажу колекції (OpenSea Studio, Magic Eden, LaunchMyNFT).
Газ: плата мережі блокчейну за транзакцію під час мінту.

Часті запитання

Персонаж щоразу виходить різним. Що робити?

Візьміть чітку базову картинку; підніміть силу референсу до 0.5–0.65; пропишіть у keep, хто персонаж і в якому стилі; увімкніть Style lock; зменшіть кількість змінних рис.

Скільки коштує серія?

Натисніть «Порахувати» — побачите точну оцінку. Орієнтовно fal.ai ~$0.025 за кадр, тобто 100 картинок ≈ $2.5. Локальні двигуни й mock — $0.

Як не витратити забагато?

Задайте SERIES_SPEND_CAP_USD у .env (наприклад, 5), завжди починайте з пілоту на 3–5 картинок і стежте за «Витратами сьогодні» у «Ресурсах».

Я перегенерував картинку, а стара була краща. Вона пропала?

Ні. У Відборі натисніть позначку v·N на картинці й оберіть потрібну версію — «Зробити поточною».

Випадково видалив базову картинку. Як повернути?

Вкладка «Ресурси» → «Кошик» → «Відновити». Файли зберігаються 30 днів.

Пише «Daily spend cap…» і не генерує.

Сьогодні досягнуто денної межі. Зменште кількість, зачекайте до завтра або підніміть SERIES_SPEND_CAP_USD у .env і перезапустіть майстерню.

Генерація зупинилась з повідомленням про помилки поспіль.

Двигун кілька разів відповів помилкою (немає коштів на рахунку, невірний ключ, збій сервісу). Перевірте ключ і баланс («Ресурси» → «Перевірити всі підключення»), потім запустіть «Усі відсутні».

Кнопка «Згенерувати» неактивна.

Спершу натисніть «Порахувати (безкоштовно)». Так майстерня показує ціну до витрат.

Промпт заблоковано через бренди.

У тексті є назва бренду, франшизи чи знаменитості. Замініть її загальним описом — це захищає від юридичних проблем на маркетплейсі.

Криві руки й обличчя. Що робити?

Позначте ↻ і переробіть; допишіть у suffix «detailed hands, symmetrical face»; спробуйте інший двигун чи силу, порівнявши набори у Відборі.

Де мої файли?

Пресети — presets/, базові картинки — input/, архіви й картинки — out/, версії — out/<набір>/versions/, кошик — out/trash/, журнал витрат — out/render-log.jsonl.

Як додати ключ API?

Скопіюйте .env.example у .env у корені проєкту, впишіть ключ (напр. FAL_KEY=...) і перезапустіть майстерню. Значення ключа браузер не бачить.

Чи можна відкрити майстерню з телефона чи іншого ПК?

За замовчуванням ні — вона працює лише на 127.0.0.1. Це навмисно, для безпеки.

Як навчити власну модель (LoRA)?

Експорт → «📦 LoRA Training Dataset». ZIP з парами «картинка + опис» завантажте в Kohya_ss або Replicate LoRA Trainer.

Запуск і зупинка

Запуск: start-lab.bat (Windows) або npm start. Адреса: http://127.0.0.1:5344/studio/. Зупинка: stop-lab.bat або Ctrl+C у вікні сервера. Мову інтерфейсу можна змінити кнопками UK / EN угорі; фіолетові підказки ховає перемикач «Підказки».