YouTube 字幕转 SRT:保留时间戳

先拿到 standard 格式的字幕 JSON,再在本机把起始时间和持续时间写成 SRT。下方脚本只处理已有文件,运行时不会调用接口。

文档核对: 2026-11-14 · 作者 PostToData

先取得一条带时间的字幕轨道

可打开字幕工具查看样例,或查阅字幕接口,用 standard 格式获取数据。将成功返回的 JSON 保存为 transcript.json。复制的整段纯文本缺少字幕片段边界,不能用于此脚本。

生成 SRT 文件

将代码保存为 to_srt.py,再运行 python3 to_srt.py < transcript.json > subtitles.srt。脚本对片段排序,保留正文;没有可用时间片段时会退出。

导入剪辑软件核对

对照原视频看开头、中间转场和末尾。如果来源的字幕有重叠,或当前视频经过剪辑,先调整时间再导入。复用字幕前核对授权。

SRT 转换脚本

示例代码
import json, math, sys

def clock(ms):
    seconds, ms = divmod(ms, 1000)
    minutes, seconds = divmod(seconds, 60)
    hours, minutes = divmod(minutes, 60)
    return f"{hours:02}:{minutes:02}:{seconds:02},{ms:03}"

payload = json.load(sys.stdin)
items = payload.get("data", {}).get("items", [])
segments = items[0].get("segments", []) if items else []
cues = []
for cue in sorted(segments, key=lambda cue: cue["start"]):
    start, duration = cue["start"], cue["duration"]
    text = "\n".join(line.strip() for line in cue["text"].splitlines() if line.strip())
    if not (math.isfinite(start) and math.isfinite(duration) and start >= 0 and duration > 0 and text):
        continue
    a = round(start * 1000)
    b = max(a + 1, round((start + duration) * 1000))
    cues.append(f"{len(cues)+1}\n{clock(a)} --> {clock(b)}\n{text}")
if not cues:
    sys.exit("No timed captions in the input JSON.")
sys.stdout.reconfigure(encoding="utf-8")
print("\n\n".join(cues))

示例来源与参考资料

当前价格与真实接口

操作每次成功调用1,000 次成功调用
YouTube · 视频字幕$0.003$3.00

1,000 次是标价乘以调用次数,不是 1,000 条数据,也不是充值套餐。以下仅预览第一项操作的价格,不访问数据上游、不扣额度。正式获取数据时移除 dry_run=1 并使用 Authorization: Bearer API_KEY;保留 max_price_usd 防止价格超过批准值。

免费价格预览
curl --get "https://posttodata.com/v1/youtube/transcript" \
  --data-urlencode 'id=UF8uR6Z6KLc' \
  --data-urlencode 'format=standard' \
  --data-urlencode 'max_price_usd=0.003' \
  --data-urlencode 'dry_run=1'

费用上限只限制当前一次调用,不是整个任务的共享预算。逐项批准调用数量,遇到 402、412 或 429 时停止,不能自动提价或更换账号重试。

常见问题

无字幕视频能转出 SRT 吗?

这套方法使用已有字幕轨道。来源没有可用的带时间字幕时,脚本不会生成字幕条目。

相关指南

浏览全部指南 →