SuperAPI AI 工具集

burn-in-captions

设计与创作

查看项目

更新于 10-15 21:54

技能介绍

用途:把原始视频片段转成带词级同步字幕的成片,采用确定性的预设风格。触发场景包括“给这个片段加字幕”“烧录字幕”“做卡拉OK/TikTok风格字幕”等需要下三分之一词同步文本的视频交付。

主要能力:内置多种预设风格,默认 frosted-subtle;动态风格包括 kinetic-pop、word-flash、bold-accent、serif-accent、clean-minimal、neon-glow、clean-bubble、energy-pop 等,均基于真实参考视频复刻,视觉规格记录在 references/caption-styles.md。可用 --style 选择,--accent "#RRGGBB" 覆盖强调色,--emphasis word1,word2 指定重音词。部分风格(neon-pop、keyword-pill、impact-italic)为计划中,尚未构建模板,调用会报 FileNotFoundError。

使用方式:运行 python3 .claude/skills/burn-in-captions/scripts/caption.py --video path/to/clip.mp4,可加 --style、--accent、--emphasis、--word-fix、--position、--y-pct 等参数;多风格用逗号分隔。流程为:用 ffmpeg 提取单声道 16kHz 音频,上传 fal.ai(fal-ai/whisper,chunk_level: word)转写,生成 words.json 及 .srt/.ass;cue_builder 按风格分组并选重音词;ASS 路径用 ffmpeg -vf "ass=captions.ass:fontsdir=fonts/" 烧录,Remotion 路径写 cues.json 后 npx remotion render。每次运行输出 words.json、captions.srt、captions.ass 及烧录视频,多风格运行生成 storyboard.html 供审阅。

限制与要求:需 ffmpeg、ffprobe 在 PATH;Python 依赖 fal_client、jinja2(缺失时自动 pip install --user);需 FAL_API_KEY 或 FAL_KEY,或最近 .env;Remotion 风格需 node ≥ 18 与 npx。默认假设 9:16 竖屏,字幕位于下三分之一(约 y=72%),88% 安全区,pill/box 风格会收缩适配。Whisper 可能把品牌名同音误拼,可用 --word-fix 修正并持久化到 words.json。转写失败会直接报错,不编造内容。其他平台、收费与效果信息暂未提供。