Capslane icon

Capslane

Capslane 是 YouTube transcript API,可提取公开视频字幕,并在字幕缺失时生成文本;为开发者提供单一端点、带时间戳输出、语言选择及面向生产环境的控制功能。

Capslane

概览

Capslane 是 YouTube transcript API,可从公开视频中获取字幕,并在字幕不可用时生成文本稿。它面向需要使用单一端点进行字幕提取、生成式备用处理和带时间戳输出的开发者。

该 API 为原生、生成和缓存结果提供稳定的响应契约。文档和定价页面显示,它支持服务器端 API 密钥、异步任务、共享缓存、月度用量限制,以及面向生产工作流的用量跟踪工具。

主要功能

原生字幕与 AI 备用方案

从公开视频中提取字幕,或在字幕缺失时生成文本稿,通过一个 API 和统一的响应契约完成。

灵活的输出格式

可返回纯文本或带时间戳的片段。文档还指出支持结构化 JSON 输出和文本模式。

语言选择

选择用于提取的首选 ISO 语言代码。如果确切的语言轨道不可用,API 会回退到第一个可用的文本稿,并报告其他语言。

异步任务流程

通过异步任务处理较长视频。API 可以返回任务 ID,单独的任务端点会持续报告状态,直到任务完成。

稳定的缓存响应

通过共享文本稿缓存复用结果。缓存、原生和生成的响应保持相同结构,从而简化下游处理。

生产环境控制

在更高等级的计划中使用工作区 API 密钥、请求历史、月度用量限制和请求日志,以管理生产环境用量。

常见使用场景

  • 支持备用文本稿处理的视频应用

    为视频应用构建文本稿功能:先尝试原生字幕,在字幕缺失时回退到生成文本,同时无需更改代码所使用的响应结构。

  • 搜索和分析流程

    为搜索、分析或检索工作流建立文本稿索引,以满足对带时间戳片段和一致语言元数据的需求。

  • 长时间运行的文本稿任务

    通过异步请求流程处理较长视频,轮询任务状态直到文本稿准备就绪,而不是阻塞初始请求。

  • 团队 API 运营

    通过将密钥保存在服务器端、跟踪月度限制,并在更高等级的计划中查看请求历史或日志,为团队或产品管理生产环境用量。

Pros and Cons

Pros

  • 将原生字幕提取和生成式备用方案结合在一个 API 中。
  • 让原生、生成和缓存响应保持相同格式。
  • 支持带时间戳的片段、纯文本输出和语言选择。
  • 提供服务器端密钥、工作区配额和用量跟踪,适用于生产环境。
  • 提供免费层级和适合用量增长团队的高用量付费计划。

Cons

  • 文档称,生成的文本稿可能需要轮询任务端点,因此部分请求不会立即完成。
  • 可靠性页面指出,YouTube 的可用性会因地区、账户状态和上游变更而有所不同,因此无法保证每个视频都能覆盖。

FAQ

如何进行请求身份验证?

Capslane 使用工作区 API 密钥通过 x-api-key 请求头向其 transcript API 发送请求。文档说明,应在控制面板中创建服务器密钥,并将其保存在服务器端。

可以请求特定的文本稿语言吗?

可以。API 接受首选的 ISO 语言代码。如果该语言轨道不可用,Capslane 会返回第一个可用的文本稿,并列出可用语言。

如果视频没有字幕会怎样?

当没有可用字幕且模式允许生成时,Capslane 会启动异步任务并返回任务 ID。随后轮询任务端点,直到文本稿完成或失败。

缓存的文本稿会返回不同的响应格式吗?

是的。原生、生成和缓存的文本稿使用相同的响应结构;cached 字段会指示是否无需进行提取。

提供免费层级吗?

定价页面显示,Capslane 提供每月 50 次请求的免费计划,以及适用于更高月度请求量的付费计划。用量按月重置,年度订阅也不例外。

Quick Facts

类别
开发者工具
主要用途
YouTube 字幕提取和文本稿生成
平台
Web API
身份验证
x-api-key 请求头中的工作区 API 密钥
来源域名
capslane.com
定价
免费层级及付费计划