Сцена

Сцена — это отдельный временной фрагмент фильма со своими свойствами и собственным набором элементов. Если фильм — это весь ролик целиком, то сцена — это одна его часть, которая длится определённое время и содержит конкретное визуальное и звуковое наполнение.

На уровне сцены описывают не глобальные настройки всего видео, а то, что происходит внутри конкретного фрагмента: сколько он длится, какой у него фон, какие в нём элементы, при каких условиях он показывается и как переходит в следующую сцену. Для глобальных параметров смотрите страницу Фильм, а для правильной постановки задач — гайд по формулировке запросов.

Свойства сцены

Ниже приведены основные свойства сцены. Именно их нужно называть в запросе к ИИ, если вы меняете не весь фильм, а конкретную сцену. Самое важное свойство — duration, потому что оно определяет длину сцены во времени.

Свойство	Описание	Как правильно запрашивать у ИИ
`duration`	Длительность сцены. Это главное свойство сцены, потому что именно оно задаёт, сколько времени сцена существует в фильме. От него зависит ритм ролика и расположение следующих сцен.	«В сцене 2 увеличь `duration` до 6 секунд» или «В первой сцене уменьши `duration` на 2 секунды».
`background-color`	Цвет фона сцены. Используется, когда сцена должна иметь сплошной фон без отдельного фонового изображения или видео.	«В сцене 1 установи `background-color` = `#000000`» или «Сделай фон второй сцены белым».
`transition`	Эффект перехода к следующей сцене. Он определяет, как одна сцена сменяет другую: плавно, резко, со сдвигом, растворением и так далее. Список переходов смотрите на странице Переходы сцен.	«В сцене 3 установи `transition` = `fade`» или «Для второй сцены измени переход на slide left».
`elements`	Список всех элементов внутри сцены: текст, изображения, видео, звук, HTML, компоненты и другие локальные объекты.	«В сцене 2 в `elements` добавь новый `text`» или «Удали лишний `image` из списка `elements` в третьей сцене».
`condition`	Условие показа сцены. Позволяет указать, когда сцена должна отображаться, а когда нет.	«Для сцены 4 добавь `condition` для показа только в акционной версии ролика».
`variables`	Локальные переменные сцены. Используются, когда именно в этой сцене нужны отдельные значения, отличающиеся от глобальных переменных фильма.	«В сцене 1 добавь в `variables` локальный заголовок и цену» или «Обнови `variables` второй сцены».
`iterate`	Управляет повторением или итерацией сцены по набору данных. Полезно для шаблонов, где одна сцена генерируется несколько раз с разными значениями.	«В сцене 5 настрой `iterate` для списка товаров» или «Добавь итерацию сцены по массиву карточек».
`cache`	Кеширование конкретной сцены. Позволяет переиспользовать уже сгенерированный результат или принудительно пересчитать сцену.	«Для сцены 2 отключи `cache` и сгенерируй её заново» или «Включи `cache` для повторяющейся сцены».
`comment`	Служебный комментарий к сцене. Не показывается в кадре, а используется для пояснений, заметок или технических пометок.	«В сцене 3 добавь `comment` с пояснением для редактора».
`id`	Уникальный идентификатор сцены. Помогает точно ссылаться на сцену в шаблонах, интеграциях или при техническом сопровождении.	«Назначь сцене `id` = `intro-offer`» или «Обнови `id` третьей сцены».

Главное: если вы меняете duration, transition, background-color или elements, в запросе нужно прямо сказать, что это изменение сцены, а не фильма в целом.

Элементы сцены

Внутри сцены находятся её локальные элементы. Они живут только в пределах времени этой сцены и не являются глобальными для всего ролика.

Элемент	Краткое описание
`video`	Видеофрагмент, который показывается только в этой сцене.
`image`	Изображение или графика, принадлежащие только этой сцене.
`text`	Текстовый элемент: заголовок, подпись, короткое сообщение, CTA.
`component`	Готовый составной блок, который используется внутри сцены.
`html`	HTML-разметка или кастомное содержимое, нужное только в пределах сцены.
`audio`	Локальный звук или музыка, которые звучат только в этой сцене.
`voice`	Озвучка, относящаяся именно к этой сцене.
`audiogram`	Визуализация аудио для конкретной сцены.

Если один и тот же элемент должен быть виден на протяжении всего ролика, тогда это уже объект уровня фильма, а не сцены.

Как правильно запрашивать изменения сцены

Для запроса изменений сцены лучше всего работает формула: номер или ID сцены → свойство или элемент → конкретное действие.

Сначала укажите, какую именно сцену вы меняете.
Затем назовите её свойство или конкретный элемент.
После этого чётко опишите, что именно нужно сделать.

Нечётко	Правильно
«Сделай длиннее»	«В сцене 2 увеличь `duration` до 6 секунд»
«Поменяй фон»	«В сцене 1 установи `background-color` = `#FFFFFF`»
«Сделай другой переход»	«Для сцены 3 измени `transition` на `fade`»
«Добавь текст»	«В сцене 2 в `elements` добавь новый элемент `text` с заголовком “Весенняя акция”»
«Убери картинку»	«В сцене 4 удали элемент `image` из списка `elements`»
«Переделай сцену»	«В сцене 5 обнови `variables`, измени `duration` на 4 секунды и установи `transition` = `fade`»

Если вы меняете не всю сцену, а только один её элемент, формулируйте ещё точнее: «В сцене 2 элемент text замени на новый заголовок» или «В сцене 3 элемент audio сделай тише на 30%».

Связанные страницы: Фильм, Переходы сцен, Гайд по постановке задач.