YouTube 文字稿 API Python — 用 requests 快速上手

一个请求，一份文字稿

最短路径是在 Authorization 头中带上密钥，GET /v1/transcripts/{videoId}。响应是 JSON：视频 ID、语言、时长和片段列表。无需 SDK——requests 或 httpx 就够。

若视频可能多语言，先调用 /v1/transcripts/{videoId}/languages 选择轨道，再传 ?lang= 和 ?format=。请求 srt 或 vtt 返回可直接保存的字幕；json 保留结构化片段。

对列表，一次调用向 /v1/transcripts 发送最多 50 个 ID，并读取每项结果。加上超时和小的指数退避：瞬时故障和 429 很快恢复，且每个响应都带可记录的 X-Request-ID。

有些视频没有字幕，有些是私密或区域受限。API 返回带类型的错误码和可读消息，因此你的代码依据错误码分支，而非解析文字。记录 request id——这是最快定位修复的途径。

常见问题

需要 SDK 吗？

不需要。任何 HTTP 客户端都可以。对 requests 的简单封装足以应对多数项目。

如何批量处理很多视频？

向 POST /v1/transcripts 发送最多 50 个视频 ID；更大的集合放入播放列表或频道任务。

异步 Python 呢？

使用 httpx.AsyncClient 调用相同端点，并用有界信号量控制并发。