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.
  • Лучшая формула запроса — уровень → свойство или элемент → точное действие.

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