Reframe API 用例

上次更新日期: 2026年9月22日

了解 Reframe API 及其最适合的用例。

Reframe API 通过智能跟踪每个镜头最重要的部分并围绕其重新构图来修改视频的纵横比。重新构图输出中的所有内容完全来自源视频,API 从不生成新像素来填充空间。

最佳用例

Reframe API 在以下方面表现可靠:

  • 需要标准社交媒体纵横比的视频: 16:9 纵横比的视频转换为 9:16、1:1、4:3 和 4:5 输出以适应不同渠道是主要用例。您还可以指定精确的输出分辨率(例如,1920 × 1080),实现像素级精准输出。 
  • 真人拍摄和现实世界素材:采访、产品拍摄、生活方式和活动素材以及其他相机拍摄的视频可以完美重新构图。自然的相机运动会自动平滑,没有任何可见的伪像。 
  • 以一个主要主体为特色的镜头:主要主体(如人物、产品或焦点)在整个重新构图过程中始终保持在画面内。借助语义主体锁定,您可以使用关键词或提示命名目标主体(例如,穿黄色夹克的男子飞盘),Reframe API 将在每个镜头中跟踪它。 
  • 具有清晰剪切的多镜头视频:激活场景编辑检测后,API 可以分析每个转场并在所有输出比例的每个镜头内保持稳定的构图。 
  • 需要一致叠加的视频:可以应用预生成的叠加(PNG 或 GIF),控制计时、位置、缩放和循环,并在您生成的所有纵横比中保持对齐。

不适合的用例

由于 Reframe API 只在现有像素内重新定位和裁切,它从不生成新内容来填充空间。 以下内容类型在重新构图时会降级或失败:

  • 全画面屏幕文字和下三分之一字幕:烧录到源视频中的标题、题注、制作人员名单和图形占据原始纵横比的全部宽度。当画面裁切为更窄的比例(如从 16:9 到 9:16)时,Reframe API 会在边缘截断文字,因为它无法重新排列烧录内容,只能移动裁切窗口。 对于包含文本和图形的视频,请先对原始视频重新构图,再使用 DGR(搭配不同尺寸的 MOGRT)在视频上叠加文本。
  • 存在多个主体同时运动的场景:语义主体锁定仅可在整个重新构图过程中跟踪单个主体。当两个或更多主体同等重要且空间分离时,如宽镜头中的双人采访、专题讨论或涉及球和远处球员的体育比赛,裁切只能保持一个主体。其他主体会落在画面之外。
  • 快速或模糊的场景切换:场景编辑检测可在过渡中保持构图完整性,但极快的切换、强烈闪光过渡或匹配剪辑可能导致主体跟踪器锁定到错误元素,从而产生裁切路径跳跃。 
  • 固定构图的图形内容:屏幕录制、幻灯片、仪表板以及包含大量动态图形的素材没有可跟踪的主体,也无安全裁切区域。 Reframe API 将此类内容中的每个像素都视为重要,因此不应将此类内容发送到 API。
  • 动画和动态图形:徽标构建、动态文字、片头序列、品牌动画等动画内容,重新构图效果并不稳定。此类内容通常具有清晰的图形边缘和快速移动的元素,需要精确的逐帧构图,并且经常将多个以不同方向同时移动的元素组合在一起。Reframe API 针对真实世界素材进行了微调,无法足够精确地跟踪动画元素,因此输出可能看起来略有偏差或滞后于动作。处理动画时,请从原始动画源文件渲染各个纵横比版本,或通过 DGR 使用其 MOGRT,不要对已经导出完成的文件执行重新构图。 
  • 不支持的输出: Reframe API 始终生成不透明的 H.264 或 HEVC 输出。 任何透明背景(Alpha 通道)都会被展平,因为不保留 Alpha 通道。 接受 ProRes 作为输入进行解码,但不生成 ProRes 输出。