SuperAPI AI 工具集

srt-from-script

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:把 ai-video-script 风格的三段式短剧脚本转换为 SRT 字幕文件,字幕内容逐镜头对应脚本中的 VOICEOVER,时间码按镜头时长累计计算。

主要能力:解析脚本中的 OVERVIEW 与 SHOT_1..N 块,读取每个镜头的 DURATION_S 和 VOICEOVER;按累计时长生成 cue;语言保持脚本原文,中英文不翻译;带 VOICEOVER: none 或空的镜头不产生字幕,但其时长仍推进时间轴。

必要用法:该技能接受三个参数。script(必填):完整脚本文本(整个 OUTPUT FORMAT 块),通过 stdin 传入,编排器无需写临时文件。output_path(必填):输出 .srt 路径,父目录不存在时自动创建。gap_ms(可选,默认 200):从每个 cue 的结束时间减去尾部余量,使字幕在下一镜头开始前约 200ms 消失,避免切换时截断文字。leading_offset_ms(可选,默认 0):将每个 cue 整体前移该毫秒数,当合并视频在 SHOT_1 前加了标题卡/片头时设为片头时长。

输出与时间规则:SHOT_1 从 00:00:00,000 开始,SHOT_2 从 SHOT_1 的时长处开始,依此类推;每个 cue 的结束时间 = 下一镜头开始时间 − gap_ms,且钳制为不早于开始后 800ms,保证极短台词仍可读。生成的 .srt 为 UTF-8 编码,可被 ffmpeg 的 subtitles= 滤镜正常读取,并在 stdout 打印写入文件的绝对路径。

适用场景:为按 ai-video-script 格式产出的短剧脚本批量生成字幕,配合 ffmpeg 合并视频时使用。

限制:脚本必须严格符合 ai-video-script 的 OUTPUT FORMAT(=== SHOT_N === 块及 DURATION_S:、VOICEOVER: 字段);若格式偏离则产生零个 cue 并以退出码 1 结束。资料称已测试 3-5 个镜头,更多镜头也可工作但时间戳会随之增长。其他功能、收费与平台信息暂未提供。