Kod Video Maker Bot Документація

Фільм

Фільм — це весь ролик як єдина структура: його загальні налаштування, глобальні об'єкти та повний список сцен. Саме на рівні фільму визначається, у якому форматі буде зібране відео, які спільні параметри діють для всього ролика та з яких сцен він складається.

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

Властивості фільму

Нижче — основні властивості фільму, які важливо правильно називати у запиті до ШІ. Кожна властивість має свою роль: одні відповідають за формат і технічні параметри, інші — за структуру, службові дані або глобальні об'єкти ролика.

Властивість Опис Як правильно запитувати у ШІ
resolution Готовий формат розміру кадру. Зручно використовувати, коли потрібно швидко задати типове співвідношення сторін і піксельні розміри. Приклади: instagram-story — 1080×1920, squared — 1080×1080, full-hd — 1920×1080, instagram-feed — 1080×1350, hd — 1280×720. «У фільмі встанови resolution = instagram-story (1080×1920)» або «У фільмі зміни resolution на full-hd 1920×1080».
width Ширина кадру в пікселях. Використовується тільки тоді, коли потрібна нестандартна роздільна здатність. Спочатку у фільмі потрібно встановити resolution = custom, а вже потім вказати width. Якщо задано width і height, вони перекривають готове значення resolution. «У фільмі встанови resolution = custom, а потім width = 1440» або «У фільмі встанови кастомні розміри: ширина 1440, висота 810».
height Висота кадру в пікселях. Використовується тільки разом із кастомною роздільною здатністю. Спочатку у фільмі потрібно встановити resolution = custom, а потім задати height разом із width. Якщо вказані width і height, саме вони визначають фінальний розмір кадру та перекривають готовий пресет resolution. «У фільмі встанови resolution = custom, а потім height = 810» або «У фільмі встанови кастомні розміри: ширина 1440, висота 810».
quality Загальна якість рендеру або експорту. Впливає на деталізацію, стиснення та підсумкову вагу файлу. «У фільмі підвищ quality до високої» або «Встанови quality для швидкого чернеткового рендеру».
client-data Клієнтські або службові дані, пов'язані з конкретним замовленням, сценарієм чи інтеграцією. Це метадані фільму, а не його видимий вміст. «У фільмі додай у client-data назву кампанії та ID замовлення» або «Онови client-data для цього проєкту».
variables Глобальні змінні фільму, які можна використовувати в різних сценах і об'єктах. Це зручно для шаблонних роликів, де одні й ті самі значення повторюються у кількох місцях. «У фільмі додай у variables назву бренду, ціну та дату акції» або «Онови глобальні variables для всіх сцен».
comment Службовий коментар до фільму. Не є видимим елементом у кадрі, а використовується для пояснень, приміток або внутрішніх позначок. «У фільмі додай comment з поясненням для монтажера» або «Онови службовий comment у фільмі».
id Унікальний ідентифікатор фільму. Потрібен для зв'язування з іншими системами, шаблонами, базою даних або технічним обліком. «Признач фільму id = promo-spring-2026» або «Онови id фільму відповідно до нового проєкту».
scenes Список усіх сцен фільму та їхній порядок. Саме ця властивість визначає структуру ролика за часом. «У фільмі в scenes додай нову сцену після другої» або «Поміняй місцями першу й третю сцени у scenes».

Головний принцип: якщо ви змінюєте глобальну властивість ролика, у запиті потрібно прямо сказати, що це зміна фільму, а не сцени. Наприклад: «У фільмі зміни resolution на instagram-feed 1080×1350», а не просто «Зміни формат».

Об'єкти фільму

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

Об'єкт Короткий опис
videoГлобальний відеошар або відеооб'єкт, який стосується всього фільму.
imageЗображення рівня фільму: логотип, рамка, водяний знак, постійна графіка.
textТекст, який відноситься до всього ролика: заголовок, дисклеймер, загальний підпис.
componentГотовий складений блок, який вставляється на рівні всього фільму.
audioГлобальна аудіодоріжка: музика, фон або звукове оформлення на весь ролик.
voiceОзвучення або голос, який стосується всього фільму чи його основної логіки.
audiogramВізуалізація звуку на рівні всього ролика.
subtitlesСубтитри, які описують або супроводжують увесь фільм.

Якщо об'єкт має бути лише в одному фрагменті, це вже не об'єкт фільму, а елемент конкретної сцени.

Як правильно запитувати зміни фільму

Щоб ШІ правильно зрозумів задачу, у запиті бажано дотримуватися простої формули: рівень → властивість або об'єкт → конкретна зміна.

Правильна логіка формулювання:

  1. Спочатку скажіть, що зміна стосується фільму.
  2. Потім назвіть точну властивість або об'єкт.
  3. Після цього чітко опишіть, що саме треба зробити.
Нечітко Правильно
«Зміни формат відео»«У фільмі зміни resolution на instagram-story 1080×1920»
«Зроби ролик квадратним»«У фільмі встанови resolution = squared 1080×1080»
«Додай музику»«У фільмі додай об'єкт audio як фонову музику на весь ролик»
«Додай логотип»«У фільмі додай об'єкт image — логотип у правий верхній кут на весь час відео»
«Поміняй структуру»«У фільмі в scenes перемісти третю сцену перед другою»
«Додай дані про проєкт»«У фільмі онови client-data і додай назву клієнта, номер кампанії та дату запуску»

Запам'ятайте: коли ви просите змінити фільм, не варто писати загально «зміни відео». Краще одразу вказати, що саме ви змінюєте: resolution, width, height, audio, scenes тощо.

Пов'язані сторінки: Сцена, Переходи сцен, Гайд із постановки задач.