SuperAPI AI 工具集

aip-reference-style

设计与创作

查看项目

更新于 10-31 18:42

技能介绍

用途

本技能把一段参考视频的视觉风格——字幕、动态图形(标题、文字叠加、贴纸、卡片、动画图形,以及推进、抖动、闪光等镜头处理)和节拍之间的转场——迁移到用户自己的 AI Producer 剪辑中。它只复制参考的样式,不复制内容。

主要能力

  • 获取参考:可直接使用用户提供的视频文件;把用户提供的图片按给定顺序放入新目录作为静态参考;通过 start_link_download 获取 Instagram、TikTok、YouTube 链接内容,按答案中的 download_url 在过期前下载,并以 file_name 保存。
  • 预设处理:用 list_reference_presets 按名称和外观匹配并展示预设;用 get_reference_preset 和 preset_id 读取;下载 folder.download_url 并校验 sha256 与大小后解包。预设展示字幕时会自带 caption-kit,无需运行脚本。
  • 读取参考:运行 reference_frames.py 分析视频或图片目录,生成 contact-sheet-NN.jpg(每秒两帧的接触表)、transitions-NN.jpg(每行一个镜头切换,每秒十二帧)、strips/beat-NN.jpg(每个节拍最多每秒四帧)和 keyframes/beat-NN.jpg(每个节拍一帧较大画面)。长参考会分窗口分析,并在索引中标记 partial、analyzed、cuts_per_minute 等信息。
  • 字幕匹配:当参考包含字幕时,按时间标签挑选字幕处理方式(如普通行、强调词、堆叠行、颜色或透底填充),并与同一镜头无字幕时刻配对,再用 --caption-kit、--band、--entry 参数生成 caption-kit 与 kit.jpg。剪辑定稿后通过 caption_cues.py 生成字幕行,并按模板编写字幕时刻。
  • 动态图形:按参考所用的每种处理方式,复现其布局(叠加、座位、全屏覆盖、分屏)、字体、配色、形状和运动,用用户自己的内容填充。风格包中已有的类型从模板开始。
  • 转场与节奏:按参考的边界类型(硬切、闪光、模糊、推进、滑动、遮罩等)复现转场,频率与参考大致相当;参考只做硬切时也只做硬切。若用户素材是连续长镜头,则用说话人的重新构图(如 1.3 倍或更紧的取景)来承载参考的剪辑节奏。
  • 比例控制:每种处理方式的使用频率、持续时长和占运行时长比例与参考大致相当,保持参考中说话人与图形画面的平衡。

使用方式

  1. 先按 AI Producer 技能准备用户素材,上传与准备工作可与读取参考并行进行;在 project_id 返回后立即打开进度页。
  2. 获取并读取参考:有 style/style.md 的风格包时先读它及其指定的视觉与模板;否则运行 reference_frames.py 生成分析目录。
  3. 先读所有接触表,再读所有转场页,然后读带有独特处理的节拍条与关键帧。
  4. 字幕部分可在后台启动子代理,按指定简报编写字幕时刻,将匹配部分保存在 style/captions/,字体文件放在 public/fonts/。
  5. 挂载并发布字幕报告;剪辑变化后需用新的字幕行重新运行。

适用场景

用户希望让剪辑在视觉上贴近某个参考视频(字幕样式、图形风格、转场与节奏)时使用,例如模仿一条社交媒体短视频的包装风格。也支持以静帧图片作为参考,仅复制字幕、图形、配色与布局,不涉及转场与节奏。

限制

  • 参考的内容一律排除:品牌、标识、人物、产品画面、截图、文字,以及播放按钮、进度条、用户名、水印等平台或录制相关元素。
  • 参考未展示的转场不会被添加。
  • 当参考与 AI Producer 创意方向冲突时,参考优先;用户自己的文字最优先;美学规则按既定顺序优先。
  • 链接下载有错误码处理:link_private、link_region_blocked、link_age_restricted、link_unavailable、link_too_long、platform_busy、link_unsupported、link_download_busy、link_download_unavailable、link_download_failed 等,各自对应不同的用户提示或重试方式。
  • 工作文件需保存在自建目录中,禁止使用 shell 通配符删除(如 rm -f out/*)。
  • 运行需要机器上有 ffmpeg、python3 和 uv,缺失时自行安装,不作为停止读取参考的理由。
  • 图片参考不展示转场、剪辑节奏、运动或时间信息。
  • 关于费用、价格、平台支持范围等细节暂未提供。