您需要一个干净的 YouTube 视频转录,可以在本周进行索引、总结、添加字幕或输入到您的管道中。在本指南结束时,您将调用一个真实的端点,该端点返回给定视频 ID 的时间编码文本行,并且您将拥有可以直接粘贴到您的应用或自动化中的代码。
您将使用 YouTube Sub Extractor API 构建的内容
Zyla API Hub 托管 YouTube Sub Extractor API,该 API 返回 YouTube 视频的文本转录,作为一系列字幕条目。每个条目包括文本和时间元数据,您可以使用这些数据来呈现字幕、对齐摘要或将搜索结果锚定到视频中的某个时刻。
典型的用途包括:
- 自动生成带有时间对齐的字幕和闭合字幕。
- 创建长格式视频内容的可搜索索引。
- 将转录内容输入到摘要工具、嵌入管道或审核工具中。
- 在您的应用中基于转录偏移构建“跳转到”链接。
所有内容都在 Zyla API Hub 的单个 API 密钥和订阅下运行,该平台聚合了超过 10,000 个公共 API。只有一个帐户、一个 API 密钥和一个订阅 + 配额模型——不是按调用付费——因此您可以在不为每个提供商处理单独凭据的情况下进行迭代。
在 Zyla API Hub 上开始
快速尝试此 API:
- 打开 API 列表:开始 7 天试用 YouTube Sub Extractor API。
- 点击订阅或开始免费试用(如果可用)。对于您在 Zyla 的第一个 API,您通常会获得 7 天的试用或 50 次请求;请查看 API 页面以获取当前访问选项和定价。没有免费计划。
- 从仪表板复制您的 API 密钥。
- 使用 Authorization: Bearer YOUR_API_KEY 调用下面显示的端点。
端点概述
YouTube Sub Extractor API 当前公开一个专注的端点,用于获取转录:
- 端点:获取视频转录
- 方法:GET
- URL:https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- 必需参数:videoId(字符串)
发送您想要转录的 YouTube 视频的 videoId。API 将以 JSON 负载响应,其中包括成功标志和字幕条目的转录数组。每个条目包含您可以在应用中使用的文本和时间字段。
快速入门:您可以粘贴的 cURL
下面是一个完整的有效请求。将 YOUR_API_KEY 替换为您的密钥。videoId 参数是必需的,示例使用特定 ID 来演示响应形状。
curl -s -X GET "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript?videoId=eCBABjPcNyo"
-H "Authorization: Bearer YOUR_API_KEY"
官方示例响应
这是 API 对上述请求返回的真实示例 JSON。使用它来构建您的解析逻辑。
{"success":true,"transcript":[{"text":"o que a gente tem no diante","duration":3.24,"offset":0,"lang":"en"},{"text":"dos nossos olhos não dá muita esperança","duration":3.24,"offset":3.24,"lang":"en"},{"text":"no futuro daqui eu vejo a polícia","duration":3.24,"offset":6.48,"lang":"en"},{"text":"atirando a dignidade de pais de família","duration":3.24,"offset":9.72,"lang":"en"},{"text":"daqui eu vejo o estado transformando pessoas","duration":3.24,"offset":12.96,"lang":"en"},{"text":"que poderiam dar bons frutos carregado em","duration":3.24,"offset":16.200000000000003,"lang":"en"},{"text":"pessoas frustradas eu não julgo entendeu monstro","duration":3.24,"offset":19.44,"lang":"en"},{"text":"não precisa ser nenhum expert title superlotado","duration":3.24,"offset":22.68,"lang":"en"},{"text":"estudado formada uma coisa pra saber que","duration":3.24,"offset":25.92,"lang":"en"},{"text":"está tudo errado para saber qual a","duration":3.24,"offset":29.160000000000004,"lang":"en"},{"text":"posição da gente isso tem que acabar","duration":3.24,"offset":32.400000000000006,"lang":"en"},{"text":"com os palestinos abete paz [Música] gino","duration":3.24,"offset":35.64,"lang":"en"},{"text":"problema queria só paz mas não viu","duration":3.24,"offset":38.88,"lang":"en"},{"text":"o veículo agora sem proteção da vida","duration":3.24,"offset":42.120000000000005,"lang":"en"},{"text":"e arrojado mas ainda era o então","duration":3.24,"offset":45.36,"lang":"en"},{"text":"ainda disparava e agora o que eu","duration":3.24,"offset":48.6,"lang":"en"},{"text":"faço me fala na maturidade na sala","duration":3.24,"offset":51.84,"lang":"en"},{"text":"tem pesadelo é época de eleição nosso","duration":3.24,"offset":55.080000000000005,"lang":"en"},{"text":"descabelo progresso sem previsão no chão torço","duration":3.24,"offset":58.32000000000001,"lang":"en"},{"text":"pro meu filho também não vira lata","duration":3.24,"offset":61.56,"lang":"en"},{"text":"é um opção tem vaca tem sempre","duration":3.24,"offset":64.80000000000001,"lang":"en"},{"text":"cid piada pode justificar nada eu entrei","duration":3.24,"offset":68.04,"lang":"en"},{"text":"político claro que foi pra vencer nelson","duration":3.24,"offset":71.28,"lang":"en"},{"text":"é um nojo esgoto exposto é alguém","duration":3.24,"offset":74.52000000000001,"lang":"en"},{"text":"é tanta injustiça em sangue nas suas","duration":3.24,"offset":77.76,"lang":"en"},{"text":"mãos por não fazer nada a troca","duration":3.24,"offset":81…
您将使用的关键字段:
- success:布尔值,指示请求是否成功。
- transcript:字幕项目的数组。每个项目包括:
- text:该片段的字幕文本。
- duration:片段的数字长度。
- offset:从视频开始的数字起始位置。
- lang:与片段相关的语言代码。
Python 示例:获取并拼接普通转录
此代码片段调用相同的端点,并将字幕行连接成一个字符串,同时保留时间以供后续使用。它使用带有您的 API 密钥的 Authorization 头,并使用与 cURL 示例相同的 videoId,以便您可以比较输出。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "eCBABjPcNyo"
URL = "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript"
resp = requests.get(
URL,
params={"videoId": VIDEO_ID},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30
)
resp.raise_for_status()
data = resp.json()
if not data.get("success"):
raise RuntimeError("转录请求未成功")
entries = data.get("transcript", [])
# 保持简单的文本转录和时间锚的索引
full_text = " ".join([e.get("text", "") for e in entries if isinstance(e, dict)])
time_index = [{"offset": e.get("offset"), "duration": e.get("duration"), "text": e.get("text")} for e in entries]
print("转录的前 200 个字符:")
print(full_text[:200])
print("\n前 3 个时间锚:")
for anchor in time_index[:3]:
print(anchor)
节省时间的实施细节
- 身份验证:在每个请求中通过 Authorization: Bearer YOUR_API_KEY 传递您的密钥。
- 缓存:给定 videoId 的转录是您层中缓存的良好候选者,以避免在热门页面或批处理作业上重复调用。
- 分页:示例响应在一个负载中返回完整的转录数组。此端点不需要分页参数。
- 时间数学:duration 和 offset 是数字值。如果您计划呈现字幕或计算跳转链接,请按原样保留它们。
- 语言:每个片段中都包含一个 lang 代码。在路由到翻译或 TTS 管道时使用它。
- 错误处理:在使用转录数据之前检查成功标志。
在转录上构建真实功能
创建 SRT 或 WebVTT
通过将偏移和偏移+持续时间格式化为时间码,将每个转录项转换为字幕块。无论您输出 SRT 还是 VTT,都要保持条目的原始顺序。由于 API 已经拆分了转录,您只需格式化逻辑。
使用时间锚进行搜索
使用它们的偏移索引文本片段。当用户搜索时,显示匹配的行,并根据偏移显示“跳转到 01:23”链接。这减少了与搜索整个文本块相比的摩擦。
总结或提取亮点
将相邻条目分组为目标大小的块(例如,按字符数或总持续时间)。将这些块输入到您的摘要工具中,并附加每个块的起始偏移链接。
内容安全筛查
如果您进行安全或合规检查,请首先对单个片段执行这些检查。这使得定位和删除问题段落变得更容易,因为您已经拥有偏移和持续时间。
从 AI 代理调用 API(MCP)
每个 Zyla API 都可以从支持模型上下文协议的 AI 编码工具中调用。将您的 MCP 兼容客户端指向此端点:MCP。
- 通过 MCP 客户端配置提供您的 Zyla API 密钥(该端点在您为工具主机配置的 URL 中接受 apikey)。
- 从 Claude Code、Cursor 或 Windsurf 等代理,您可以连接一个工具,该工具使用此帖子中使用的相同 GET URL 和 videoId 参数。
- 代理接收 JSON 负载,并可以对转录进行后处理,例如,摘要、生成笔记或在代码注释中插入时间链接引用。
如果您是 Zyla 的 MCP 工具的新手,请从一个简单的工具定义开始,该定义包装此处显示的单个端点,并将转录数组返回给代理以进行进一步推理。
Zyla 使用的操作说明
- 访问模型:订阅 + 配额,而不是按调用付费。对于您在 Zyla 的第一个 API,您通常会获得 7 天的试用或 50 次请求。始终检查列表以获取当前限制和计费。
- 一个密钥,多个服务:您的 Zyla 密钥可以在订阅的 API 中使用,这简化了 CI/CD 和机密管理。
- 团队工作流程:将 Authorization 头存储在您的机密管理器中,并通过环境变量在您的代码库或部署平台中共享。
如果您还没有帐户,可以在 Zyla API Hub 上在几分钟内创建一个帐户,并在列表页面上订阅后立即开始调用 API。
故障排除清单
- 401/403 错误:确认 Authorization 头设置为 Bearer YOUR_API_KEY,并且密钥对您的订阅有效。
- 空转录:仔细检查 videoId 字符串,并确保视频具有可用的字幕数据。
- 意外的语言代码:记录每个片段的 lang 字段,并在需要时通过您的翻译堆栈进行路由。
- 客户端超时:设置合理的超时(例如,30 秒)并重试一次。按 videoId 缓存成功的响应。
参考:端点和参数
获取视频转录
- 方法:GET
- URL:https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- 必需查询参数:
- videoId:YouTube 视频 ID 字符串(例如,eCBABjPcNyo)
- 身份验证:Authorization: Bearer YOUR_API_KEY
常见问题
我需要什么来验证请求?
在请求头中包含 Authorization: Bearer YOUR_API_KEY。您在 API 列表页面上订阅后获得密钥。
哪些参数是必需的?
仅 videoId 是获取视频转录端点所需的。
API 是否返回时间信息?
是的,每个转录项都包含您可以用于字幕时间和跳转链接的数字持续时间和偏移字段。
是否有免费计划?
没有免费计划。对于您在 Zyla 的第一个 API,您通常会获得 7 天的试用或 50 次请求。请查看 API 页面以获取当前访问和限制。
我可以从 AI 代理调用这个吗?
是的。使用 MCP 端点并配置您的工具以使用 videoId 参数命中相同的 GET URL。有关详细信息,请参见上面的 MCP 链接。
准备好发布您的转录集成了吗?在列表页面上订阅并立即获取您的密钥:开始 7 天试用 YouTube Sub Extractor API。