PromtGen: VEO 3 guided workflow
Video Promo в PromtGen — текущий workspace для подготовки промтов под VEO 3. Важно сразу правильно настроить ожидания: он не генерирует видео внутри продукта и не пытается заменить видеоредактор. Его задача другая и более прикладная — помочь превратить разрозненную идею о товарном ролике в аккуратный video brief, где есть данные о продукте, визуальное направление, storyboard и export-форматы.
Такой workflow особенно полезен в момент, когда идея уже понятна, но ещё не собрана в форму, с которой удобно работать дальше. Вместо того чтобы держать в голове «нужен короткий ролик про продукт в премиальном стиле», пользователь постепенно раскладывает задачу на понятные части: что за товар, какие детали нельзя потерять, как он должен выглядеть в кадре, какие сцены нужны и что именно экспортировать.
На выходе пользователь получает Summary, полный prompt, prompt по отдельным сценам и JSON payload. Такой результат можно передать дальше в VEO 3 workflow или использовать как production brief для дизайнера, motion-специалиста и контент-команды.
Что такое Video Promo workspace
Video Promo работает отдельно от Image Cards. Пользователь переключается в режим Video Promo (VEO 3), после чего попадает в интерфейс с двумя темпами работы:
- Guided — последовательный workflow через Setup, Style, Storyboard и Preview;
- Fast — более быстрый режим, где ключевые поля можно редактировать без длинного пошагового мастера.
Разделение на два режима делает workspace ближе к реальному производственному процессу. Когда ролик собирается с нуля, guided workflow не даёт перескочить через важные решения: сначала база, затем стиль, затем сцены и проверка результата. Когда brief уже почти готов, Fast помогает без лишних шагов поправить стиль, длительность, пару кадров или JSON payload перед экспортом.
Setup: база ролика
Setup отвечает за исходные параметры продукта и ролика. Это точка, где vague idea превращается в рабочее задание. Здесь задаются:
- тип и категория товара;
- product description;
- длительность;
- aspect ratio;
- reference image URL/path или текстовое описание референса;
- базовый контекст, который дальше используется в storyboard и prompt builder.
Смысл этого шага не в том, чтобы заполнить форму ради формы. Чем яснее описаны товар, формат и референс, тем меньше шансов, что дальнейший storyboard уйдёт в случайную эстетическую сторону и потеряет продуктовую задачу.
PromtGen проверяет обязательные поля и показывает blockers/advisories в review rail. Например, отсутствие описания продукта или описания кадра мешает собрать нормальный prompt, а отсутствие reference image остаётся advisory: это желательно, но не всегда блокирует работу.
Specs и product elements
Отдельный слой Video Promo — характеристики и элементы товара. Он нужен для тех случаев, когда ролик должен быть не просто «красивым», а узнаваемо связанным с конкретным продуктом.
Product specs помогают зафиксировать конкретные свойства: материал, размер, мощность, ёмкость, состав, комплектацию, особенности конструкции. Это снижает риск получить визуально приятный, но неточный ролик, где товар выглядит убедительно только на первый взгляд.
Product elements описывают части товара, которые важно показать в кадре: экран, кнопки, упаковку, насадку, текстуру, застёжку, порт, логотип, крышку, аксессуар или другой узнаваемый элемент.
В текущей реализации списки ограничены пятью пунктами. Это нормальное ограничение для prompt workflow: brief остаётся управляемым, а VEO prompt не превращается в перегруженную спецификацию, где важные детали теряются среди второстепенных.
Visual direction
Visual direction задаёт то, как ролик должен выглядеть: стиль, фон, свет, палитра, качество и общее настроение. На практике это слой, который переводит продуктовую задачу на язык кадра: товар можно показать как marketplace-карточку, как тёмный tech reveal, как lifestyle social ad или как спокойный premium minimalism.
В проекте есть presets, но можно использовать и custom visual style override. Custom override полезен, когда задача уже имеет брендовый или производственный контекст:
- clean marketplace aesthetic;
- dark tech product reveal;
- luxury macro;
- lifestyle social ad;
- neon studio;
- industrial demo;
- calm premium minimalism.
Gemini-assisted действия могут помочь сгенерировать style direction или описание кадра, но они не создают финальный ролик. Их роль скромнее и полезнее: ускорить заполнение качественных текстовых полей, когда нужно быстрее перейти от черновой идеи к управляемому prompt.
Storyboard: scenes и shots
Storyboard — ядро Video Promo. Именно здесь brief перестаёт быть общим описанием и превращается в последовательность кадров. Он устроен как вложенная структура:
VeoFormState
-> scenes
-> shotsScene задаёт крупный смысловой блок ролика. Shot описывает конкретный кадр: длительность, действие, движение камеры, эффект, свет, overlay text, иконку и product behavior pattern.
Такой уровень детализации помогает заранее проговорить не только «какой стиль нужен», но и «что должно происходить». Для VEO prompt это критично: ролик лучше управляется, когда у каждого кадра есть действие, камера, свет и понятная роль в общей истории продукта.
Практический сценарий может выглядеть так:
- hero-shot показывает товар на чистом фоне;
- macro shot раскрывает материал или деталь;
- demo shot показывает функцию или product behavior;
- benefit shot выводит короткий overlay;
- финальный кадр возвращает продукт в центр и закрепляет ключевое сообщение.
Ограничения текущего storyboard: до 5 scenes и до 5 shots на scene. Этого достаточно для короткого product promo и помогает контролировать суммарную длительность, не превращая короткий ролик в слишком сложную постановку.
Review и export
Preview-зона собирает результат в несколько представлений:
- Summary — короткая сводка по ролику;
- Prompt — полный VEO prompt;
- JSON — структурированный payload для API-ориентированного workflow;
- per-scene prompt export — отдельные prompts по сценам.
Review rail показывает blockers и advisories. Это не формальная проверка ради галочки: для видео особенно важно, чтобы длительности shots совпадали с общей длительностью ролика, а storyboard был заполнен не только декоративными словами, но и конкретными действиями.
В итоге export делает Video Promo полезным не только как форму для промпта, но и как место согласования. Summary удобно быстро прочитать, полный prompt можно отправить дальше в VEO 3 workflow, per-scene prompts помогают работать с отдельными фрагментами, а JSON payload оставляет путь к более API-ориентированному процессу.
Что важно помнить об ограничениях
Текущий PromtGen остаётся client-only React/Vite SPA. У него нет backend API, базы данных, auth, очередей, persistent sessions или server-side AI proxy.
Gemini key читается из Vite-переменной и используется на клиенте. Для внутреннего прототипа это допустимое ограничение, но для production такой подход нужно заменить серверным proxy.
Видео внутри PromtGen не генерируется. Приложение готовит prompt, Summary и JSON payload, а не запускает VEO job и не хранит результат.
Audio layer тоже пока отсутствует в коде. Нет audio fields, audio providers и отдельного audio UI. Поэтому аудио корректно рассматривать как будущий слой поверх уже существующего storyboard, а не как реализованную часть продукта. Такая рамка честно отделяет текущий guided workflow от будущих направлений развития.