SuperAPI AI 工具集

motion-video

设计与创作

查看项目

更新于 10-16 08:29

技能介绍

用途

Motion video 用于制作 1920×1080、30fps 的动态图形视频,要求场景剪辑点落在音乐节拍上、揭示动画落在旁白词上,且音频达到广播级干净度。整个工作流完全脚本化,从事实整理到社交编码均有明确步骤。

主要能力

  • 支持两种成品风格:漫画多元宇宙(响亮、俏皮、手工感)和玻璃主题演讲(高级、平静、清晰)。
  • 音频处理通过 multix CLI 完成,包括 Gemini TTS 语音、ElevenLabs 音效、ElevenLabs 音乐创作计划和 ElevenLabs 强制对齐。
  • 提供完整的生产管线:事实 → 脚本 → multix 音频 → 强制对齐 → 节拍网格 → 按小节拼接音乐 → 时间线与混音 → HTML 合成 → lint/check/snapshot → 渲染 → 重封装 → 社交编码。
  • 附带多个脚本工具:fit-beat-grid.py(计算 BPM、BEAT0 和每小节 kick/能量表)、verify-arrangement.py(验证拼接延迟,容差 ±2ms)、measure-mix-balance.py(测量音乐与语音的混音平衡)。
  • 提供模板资源:项目脚本(generate-audio-assets、align-voiceover、arrange-music、build-timeline)、示例数据文件和合成骨架 index-skeleton.html。

使用方式

  1. 在接触文件前先确定结果:主题与来源、风格(两种之一或基于它们的新风格)、时长、语音语言(默认英语旁白 + 越南语字幕)、结尾、签名。仅在风格或事实来源未知时询问。
  2. 创建 assets/videos/<slug>/(不要覆盖已完成的版本),并按仓库约定在 plans/ 下创建计划。从本技能的 assets/templates/ 复制模板:scripts/.mjs、data/.example.json(重命名为 .json)、hyperframes.json、index-skeleton.html 作为 index.html,以及 scripts/fit-beat-grid.py。
  3. 逐步遵循 references/production-pipeline.md,每一步写入的文件供下一步读取,不要重排顺序。
  4. 使用 references/audio-and-beat-sync.md 处理音乐:拟合网格、拼接小节使 drop 落在脚本需要的位置、验证拼接、测量语音/音乐平衡。
  5. 使用 references/composition-contract.md 和所选风格参考构建 index.html,从 assets/templates/index-skeleton.html 开始。当场景类型重复(统计、图表、终端、图形、结尾)时,遵循演示中该场景的编排,而不是发明新的。
  6. 仅当“完成条件”中所有检查通过时才结束;报告测量数字,而非印象。
  7. 将凭据保留在 multix 自己的配置中。切勿打印 API 密钥或将其复制到项目文件、计划或报告中。

适用场景

  • 制作新视频(两种风格之一)。
  • 将现有视频重新风格化为单独项目。
  • 部分重做:新音乐、重新定时 drop、重新混音、重新渲染、社交编码。

限制

  • 不处理生成式文生视频素材(直接使用 multix Seedance/Veo)。
  • 不处理 React/Remotion 合成或通用 HyperFrames 问题(使用 hyperframes 或 remotion 技能)。
  • 不负责发布到社交账号:生成文件后由用户自行发布。
  • 两个成品版本的工作项目未捆绑在此处,因为生成的旁白、音乐和音效体积大且受提供商许可限制。

完成条件

  • hyperframes lint 和 check 通过;每个场景的快照已审查。
  • verify-arrangement.py 报告每个片段在 ±2ms 内,measure-mix-balance.py 显示音乐比语音低约 4–6 dB。
  • ffprobe:1920×1080、30fps、预期时长、AAC 48kHz 立体声;ebur128 ≈ −14 LUFS,峰值 ≤ −1 dBFS;blackdetect 在淡入淡出之外未发现黑帧。
  • build-timeline 未打印剪辑/重叠/缺失词警告。
  • 屏幕上的事实可追溯到步骤 1 收集的来源。

资源

  • references/production-pipeline.md:从脚手架到社交编码和工作室预览的每条命令,以及重建表。
  • references/audio-and-beat-sync.md:语音、音效提示、音乐计划、小节拼接编排、锚点、混音数字和闪避陷阱。
  • references/composition-contract.md:TIMING 形状、辅助函数、确定性、场景窗口、字幕、吉祥物、渲染器限制、签名。
  • references/style-glass-keynote.md / references/style-comic-spiderverse.md:每种风格的令牌、字体、图层、组件、过渡和字幕外观。
  • scripts/fit-beat-grid.py <music> [--min-bpm N --max-bpm N]:BPM、BEAT0 和每小节 kick/能量表。
  • scripts/verify-arrangement.py <project> [--tolerance-ms 2]:每个片段的拼接延迟;漂移时退出码为 1。
  • scripts/measure-mix-balance.py <project>:从 build-timeline.mjs --stems 测量语音下与间隙中的音乐。
  • scripts/tests/:python -m unittest discover -s scripts/tests(需要 ffmpeg、numpy、scipy)。
  • assets/templates/:项目脚本(generate-audio-assets、align-voiceover、arrange-music、build-timeline)、示例数据文件和合成骨架。