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

Як правильно ставити задачу ШІ

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

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

Проста схема структури

Фільм
├── Властивості фільму
│   ├── resolution
│   ├── width
│   ├── height
│   ├── quality
│   ├── client-data
│   ├── variables
│   ├── comment
│   ├── id
│   └── scenes
├── Об'єкти фільму
│   ├── video
│   ├── image
│   ├── text
│   ├── component
│   ├── audio
│   ├── voice
│   ├── audiogram
│   └── subtitles
└── Сцени
    ├── Сцена 1
    │   ├── Властивості сцени
    │   │   ├── duration
    │   │   ├── background-color
    │   │   ├── transition
    │   │   ├── elements
    │   │   ├── condition
    │   │   ├── variables
    │   │   ├── iterate
    │   │   ├── cache
    │   │   ├── comment
    │   │   └── id
    │   └── Елементи сцени
    │       ├── video
    │       ├── image
    │       ├── text
    │       ├── component
    │       ├── html
    │       ├── audio
    │       ├── voice
    │       └── audiogram
    ├── Сцена 2
    └── Сцена 3

Детальніше про рівні структури читайте на сторінках Фільм та Сцена.

Головна різниця: властивості фільму і властивості сцени

Властивості фільму стосуються всього ролика. Це глобальні параметри: формат, розмір кадру, варіанти експорту, глобальні змінні, список сцен і службові дані.

Властивості сцени стосуються тільки одного фрагмента ролика. Це локальні параметри: тривалість сцени, фон, перехід, список елементів, умови показу та локальні змінні.

Що потрібно змінити Правильний рівень Приклад
Формат усього відеоФільм«У фільмі зміни resolution на full-hd 1920×1080»
Порядок сценФільм«У фільмі в scenes перестав другу сцену на початок»
Тривалість одного фрагментаСцена«У сцені 2 збільш duration до 5 секунд»
Перехід між сценамиСцена«Для сцени 3 зміни transition на fade»
Текст усередині фрагментаЕлемент сцени«У сцені 1 елемент text заміни на “Нова акція”»

Коротко: фільм — це весь ролик, сцена — це одна частина ролика, елемент сцени — це конкретний об'єкт усередині цієї частини.

Як правильно ставити задачу ШІ

Найзручніше будувати запит за простою формулою: рівень → точна сутність → дія.

Для зміни фільму

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

  • «У фільмі зміни resolution на instagram-story 1080×1920».
  • «У фільмі встанови resolution = custom, а потім задай кастомні розміри: ширина 1440, висота 810».
  • «У фільмі додай об'єкт audio як фонову музику на весь ролик».
  • «У фільмі в scenes додай нову сцену після першої».

Для зміни сцени

Якщо змінюється окремий часовий фрагмент, вкажіть номер або id сцени, а потім її властивість.

  • «У сцені 2 збільш duration до 6 секунд».
  • «У сцені 1 встанови background-color = #FFFFFF».
  • «Для сцени 3 зміни transition на fade».
  • «У сцені 4 онови variables для локального заголовка і ціни».
  • «У сцені 5 вимкни cache і перегенеруй її».

Для зміни елемента сцени

Якщо змінюється не вся сцена, а лише один її елемент, запит має бути ще точнішим: сцена → елемент → дія.

  • «У сцені 2 елемент text заміни на “Весняний розпродаж”».
  • «У сцені 1 елемент image заміни на нову картинку товару».
  • «У сцені 3 елемент audio зроби тихішим на 30%».
  • «У сцені 4 елемент voice заміни на нову озвучку».
  • «У сцені 2 в elements додай новий елемент html».

Неправильні запити

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

Неправильно Чому це погано
«Зміни формат»Не зрозуміло, чи йдеться про весь фільм, яку саме властивість треба змінити і на яке значення.
«Додай музику»Не сказано, це музика для всього ролика чи тільки для однієї сцени.
«Зроби коротше»Не вказано, що саме потрібно скоротити: увесь фільм, конкретну сцену чи окремий елемент.
«Поміняй текст»Не зрозуміло, у якій сцені і який саме текст треба змінити.
«Зроби інший перехід»Не сказано, для якої сцени змінюється transition.

Правильні запити

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

Рівень Правильний запит
Фільм«У фільмі зміни resolution на squared 1080×1080»
Фільм«У фільмі додай об'єкт image — логотип у правий верхній кут на весь ролик»
Фільм«У фільмі в scenes перемісти третю сцену перед другою»
Сцена«У сцені 2 збільш duration до 5 секунд»
Сцена«Для сцени 3 зміни transition на fade»
Елемент сцени«У сцені 1 елемент text заміни на “Ласкаво просимо”»
Елемент сцени«У сцені 4 елемент image пересунь праворуч»
Елемент сцени«У сцені 3 елемент audio зроби тихішим на 30%»

Головне правило

Завжди називайте точний рівень структури. Якщо зміна стосується всього ролика — пишіть «у фільмі». Якщо зміна стосується конкретної сцени — пишіть «у сцені 2» або вказуйте її id. Якщо змінюється окремий об'єкт усередині сцени — додатково називайте сам елемент: text, image, audio тощо.

Інакше кажучи, правильний запит майже завжди відповідає на три питання: де?, що?, як саме змінити?

Коротка пам'ятка

  • Фільм — увесь ролик цілком.
  • Властивості фільмуresolution, width, height, quality, client-data, variables, comment, id, scenes.
  • Сцена — окремий часовий фрагмент ролика.
  • Властивості сцениduration, background-color, transition, elements, condition, variables, iterate, cache, comment, id.
  • Елемент сцени — конкретний локальний об'єкт: video, image, text, component, html, audio, voice, audiogram.
  • Найкраща формула запиту — рівень → властивість або елемент → точна дія.

Пов'язані сторінки: Фільм, Сцена, Переходи сцен.