跳到正文
Transcript Dock
登录免费开始

站点菜单

Transcript Dock

Transcript Dock 与 youtube-transcript-api 对比

youtube-transcript-api 是一个免费的 Python 库,但 YouTube 会封锁云服务器 IP。什么时候值得为托管 API 付费,以及如何用几行代码完成切换。

先说结论:在你自己的网络环境里跑脚本和 notebook 时,继续用 youtube-transcript-api;它免费,也好用。一旦要在服务器上运行,就换成托管 API,因为 YouTube 会封锁大多数云服务器 IP 地址,这时这个库就需要付费的住宅代理。托管 API 还能覆盖 TikTok 和没有字幕的视频。

该库的相关事实核对于 2026年10月9日,依据是它的 README(版本 1.2.4)。

并排对比#

对比项Transcript Dockyoutube-transcript-api
它是什么托管 API 和 MCP 服务器开源 Python 库(MIT)
来源YouTube、TikTok、文件上传、直接媒体链接YouTube
能否在云端运行可以,无需任何配置需要轮换的住宅代理
没有字幕时付费套餐提供 AI 转录不支持
导出格式TXT、SRT、VTT、JSON文本、JSON、SRT、WebVTT 格式化工具
翻译选择已有的字幕语言YouTube 的自动翻译
费用每份文稿 1 个点数;每月 50 个免费点数免费,在云端运行时另加代理费用

云服务器 IP 的问题#

该库的 README 说,YouTube 已开始封锁大多数已知属于云服务商的 IP,这时调用会以 RequestBlocked 或 IpBlocked 失败。它建议的解决办法是使用轮换的住宅代理,这意味着多一份账单,也多一个需要监控的东西。Transcript Dock 替你处理这一部分,你按文稿数量付费,而不是按代理流量的 GB 数付费。

切换只需几行代码#

返回的分段带有以秒为单位的 start 和 end,与该库返回的 snippet 很接近。

python
# before
from youtube_transcript_api import YouTubeTranscriptApi
snippets = YouTubeTranscriptApi().fetch("dQw4w9WgXcQ")
 
# after
import requests
API, H = "https://www.transcriptdock.com", {"Authorization": "Bearer td_live_YOUR_KEY"}
job = requests.post(f"{API}/v1/jobs", headers={**H, "Idempotency-Key": "yt-dQw4w9WgXcQ"},
json={"source": {"url": "https://youtu.be/dQw4w9WgXcQ"}, "mode": "captions_only"}).json()
while job["status"] not in ("succeeded", "failed", "cancelled"):
job = requests.get(f"{API}/v1/jobs/{job['id']}", params={"wait": 25}, headers=H).json()
segments = requests.get(f"{API}/v1/transcripts/{job['result_id']}", headers=H).json()["segments"]
# each segment: {"start": 0.0, "end": 2.4, "text": "..."}

该怎么选#

  • 只用 YouTube、量不大、在你的笔记本电脑或家用服务器上运行时,选这个库。
  • 在云主机上跑生产环境、需要 TikTok、处理没有字幕的视频、导出字幕文件,或者想通过 MCP 让 Claude 和 Cursor 访问时,选 Transcript Dock。

更多方式见如何获取 YouTube 文稿。