跳转到正文
中文
获取 API 密钥

YouTube Data

YouTube 字幕 API:已有字幕,还是语音识别

对照官方字幕接口、Python 库和四家托管 API 的时间戳、缺轨道行为、Credits 与语音识别计费。

FlashData · 发布于

已有字幕轨道与语音识别具有不同的获取和计费路径。

需要 YouTube 已发布的文本与时间戳时,应选择已有字幕接口。没有字幕的视频也必须产出文本时,则需要明确支持语音识别回退的服务,并按分钟预算,不能假设只收一次低价请求。官方字幕接口要求视频管理权限,自托管库则由你负责运维。以下托管服务的缺轨道行为和计费并不相同。

服务

文本来源与时间戳

入口价格及单位

免费或试用

适用场景

YouTube Data API captions(官方)

授权下载字幕轨道;调用者必须有视频编辑权限。返回带时间信息的字幕格式,不是任意公开视频字幕接口,也不是 STT。

每次 captions.download 消耗 200 配额单位,不是每 1,000 次的美元报价。 来源 · 2026-11-15 UTC

使用项目 API 配额,并非字幕试用套餐。

视频所有者或获授权的管理者下载自己的字幕轨道。

youtube-transcript-api (jdepoix)

自托管 Python 库,读取已有人工或 YouTube 自动字幕,返回带时间信息的片段;不提供托管 STT 回退。

开源软件授权费 $0;机器及可能需要的代理另计,无法直接对比托管请求单价。 来源 · 2026-11-15 UTC

没有 SaaS 试用,需要自行运行。

愿意自行运行字幕提取、处理云 IP 被封的团队。

Supadata

带时间戳的已有字幕;无字幕时可回退到 AI 语音识别。

Basic:月等价 $5,年付 $60,每月 300 credits。已有字幕 1 credit;生成字幕每视频分钟 2 credits。 来源 · 2026-11-15 UTC

Free 每月 100 credits;生成字幕按分钟消耗,不能等同于已有字幕请求数。

无字幕轨道时仍需要文本,并愿意承担 STT 费用的应用。

TranscriptAPI

可带或不带时间戳的字幕 JSON;已核验的公开页面未说明缺少轨道是否触发 STT。

月付 $5 含 1,000 credits;1 份字幕 = 1 次成功请求 = 1 credit。 来源 · 2026-11-15 UTC

100 试用 credits,无需信用卡。

需要简单成功请求额度的应用;若无字幕处理很关键,应先确认该行为。

Captapi

已有字幕:FAQ 明确缺轨道返回 404 no_captions,消耗 0 credits。已核验公开页未明确字幕时间戳字段。

Starter 月费 $9,含 2,000 credits。未核实字幕接口每次 credits,不能当成 2,000 份字幕。 来源 · 2026-11-15 UTC

验证邮箱后 100 lifetime credits,不是每月补充。

使用其更广 API 产品,并接受无字幕明确失败的团队。

FlashData YouTube Data

Transcript 默认 YouTube 自动字幕,Captions 默认上传者字幕,均返回带时间戳文本。不生成转写、不翻译、不自动切换字幕来源。

PAYG 每 1,000 次标准请求 $0.50,无月费。 来源 · 2026-11-15 UTC

新账户共享试用 Credits;失败请求不计费。

需要已有字幕、明确选择字幕来源及时间戳片段的应用。

FlashData 的 Google Search及 YouTube 下载 是共用账户 Key 的独立产品。下载字节并不是上表 YouTube Data 的计费单位。

YouTube 自动字幕仍然属于已有轨道

“自动”既可能指 YouTube 已生成的字幕,也可能指服务商现在对音频进行识别,二者不是同一操作。jdepoix 库读取已有人工或自动轨道,并支持 YouTube 提供的翻译;Google 授权 captions.download 也有翻译参数。这不代表 FlashData 会翻译或生成缺失轨道。

FlashData 的 Transcript 默认选自动字幕,Captions 默认选上传者字幕。auto 参数用于明确选择来源,API 不会静默切换。两者都返回时间戳片段和完整文本;请求的轨道或语言不存在时,不会转为 STT。

没有字幕也必须返回文本时

Supadata 明确说明,缺少字幕时通过同一接口使用 AI 语音识别。生成字幕按视频分钟消耗,已有字幕则按请求消耗 credits。定价页给出每月 100-credit 免费预算;产品页“100 requests/month”的文案不应解释成 100 份任意时长的生成字幕。

Captapi 文档说明返回 no_captions,而不是自动转写。TranscriptAPI 的公开定价和示例证明支持时间戳及一次成功请求一个 credit,但本次未核实其缺字幕策略。如果这一行为影响选型,应确认接口文档,而非从“transcript API”这个名称推断。

区分配额、请求费与使用权

YouTube 官方字幕 API 需要 OAuth 授权和视频编辑权限。200 配额单位不是美元费率,不能凭空兑换成托管 API 每 1,000 次请求价格。自托管 youtube-transcript-api 的运行成本及云 IP 封锁问题由调用方承担。

FlashData Extended Search 费率不同于标准 YouTube Data 请求,与取字幕无关。许可证检查仅报告视频是否标记 Creative Commons,不授予训练权。试用 Credits 在账户内共享。标记失败的任务不计费;仅客户端超时并不证明任务已失败。

选型后的实现资料

FlashData 的具体实现可参考 Supadata 对照, JavaScript 字幕教程, 字幕语言选择, Transcript 文档及 Captions 文档.

数字从哪来

价格均为美元,官方页面查阅日期为 2026-11-15 UTC。本文由 FlashData 根据各厂商文档编写,不是独立性能测试。