Варіанти використання API Reframe

Останнє оновлення: 22 вер. 2026 р.

Дізнайтеся про API Reframe та варіанти використання, для яких він найкраще підходить.

API Reframe змінює співвідношення сторін відео, інтелектуально відстежуючи найважливішу частину кожного кадру та перекомпоновуючи рамку навколо неї. Весь вміст у перекадрованому результаті походить виключно з вихідного відео, і API ніколи не генерує нові пікселі для заповнення простору.

Найкращі варіанти використання

API Reframe надійно працює з:

  • Відео, які потребують стандартних пропорцій для соціальних мереж: Конвертація відео з співвідношенням сторін 16:9 у формати 9:16, 1:1, 4:3 і 4:5 для різних каналів є основним варіантом використання. Ви також можете вказати точну вихідну роздільну здатність (наприклад, 1920×1080) для піксельно-точної доставки. 
  • Ігрове та реальне відео: Інтерв'ю, знімки продуктів, лайфстайл та відео подій, а також інші відеозаписи, зняті камерою, перекадровуються чисто. Природний рух камери автоматично згладжується без будь-яких видимих артефактів. 
  • Кадри з одним домінуючим об'єктом: Домінуючий об'єкт, такий як людина, продукт або фокусна точка, залишається в кадрі протягом усієї перекомпозиції. За допомогою функції Semantic Subject Lock ви можете назвати цільовий об'єкт, використовуючи ключове слово або запит (наприклад, чоловік у жовтій куртці або фрісбі), і API Reframe відстежуватиме його в кожному кадрі. 
  • Багатокадрові відео з чистими переходами: Виявлення монтажних переходів, коли активовано, дозволяє API аналізувати кожен перехід і зберігати стабільну композицію в кожному кадрі для всіх вихідних співвідношень. 
  • Відео, які потребують послідовних накладень: Попередньо створені накладення (PNG або GIF) можна застосовувати з контролем хронометражу, позиції, масштабу та зациклення, і вони залишаються вирівняними для всіх співвідношень сторін, які ви генеруєте.

Непридатні варіанти використання

Оскільки API Reframe лише переміщує та кадрує в межах існуючих пікселів, він ніколи не генерує новий вміст для заповнення простору. Наступні типи вмісту погіршуються або не працюють при перекадровці:

  • Повнокадровий екранний текст та нижні титри: Заголовки, підписи, титри та графіка, вбудовані у вихідне відео, займають повну ширину початкового співвідношення сторін. Коли кадр обрізається до вужчого співвідношення, наприклад з 16:9 до 9:16, API Reframe обрізає текст по краях, оскільки не може перевпорядкувати вбудований вміст — він може лише переміщати вікно кадрування. Для відео з текстом та графікою спочатку перекадруйте чисті відео, а потім використовуйте DGR (з різнорозмірними MOGRT) для накладання тексту на них.
  • Багатосуб'єктні сцени з одночасною дією: Semantic Subject Lock може відстежувати лише один об'єкт протягом усієї перекомпозиції. Коли два або більше об'єктів однаково важливі та просторово розділені, наприклад інтерв'ю двох людей у широкому кадрі, панельна дискусія або спортивна гра з м'ячем та далеким гравцем, кадрування може утримати лише один об'єкт. Інші залишаються за межами кадру.
  • Швидкі або неоднозначні зміни сцен: виявлення монтажних переходів підтримує композиційну цілісність між переходами, однак дуже швидкі зміни, різкі переходи зі спалахом або зіставлення можуть призвести до того, що система відстеження об’єкта зафіксується на неправильному елементі, створюючи стрибки в траєкторії кадрування. 
  • Вміст із фіксованою композицією графіки: записи екрана, колоди слайдів, інформаційні панелі та відеоматеріал із великою кількістю моушн-графіки не мають об’єкта для відстеження та безпечного кадрування. API Reframe розглядає кожен піксель такого вмісту як важливий, тому такий вміст не слід надсилати до API.
  • Анімація та моушн-графіка: Анімований вміст, як-от побудова логотипів, кінетична типографіка, титульні послідовності та анімація бренду, не переформатовується надійно.Такий вміст часто має чіткі графічні краї та швидкорухомі елементи, що потребують точного покадрового кадрування, і часто поєднує кілька елементів, що рухаються в різних напрямках одночасно. API Reframe налаштовано для реального відеоматеріалу та не може відстежувати анімовані елементи з достатньою точністю, тому результат може виглядати трохи невірно або відставати від руху. Для анімації виконуйте рендеринг кожного співвідношення сторін з оригінального джерела анімації або його MOGRT через DGR, а не переформатовуйте готовий експорт. 
  • Непідтримувані форми вихідних даних: API Reframe завжди створює непрозорий вихід H.264 або HEVC. Будь-який прозорий фон (альфа-канал) згладжується, оскільки альфа не зберігається. ProRes приймається як вхідні дані для декодування, але не створюється як вихідні дані.