核心功能
Transcript 是一款专为 YouTube 视频设计的字幕提取工具，通过 TranscriptAPI.com 服务，可将任意公开 YouTube 视频（包括标准视频、Shorts 短片）转换为结构化文本数据。支持多种输入格式：完整 URL、短链接 youtu.be、或直接输入 11 位视频 ID。
输出格式
- JSON 格式：返回逐句字幕对象，包含
text、start起始时间、duration持续时间，适合精确引用特定时刻 - Text 格式：生成带
[HH:MM:SS]时间戳的连续文本，便于快速阅读与复制 - 元数据：可同时获取视频标题、作者信息、缩略图等
典型使用场景
| 场景 | 推荐参数 |
|------|---------|
| 快速摘要视频内容 | `format=text`, `include_timestamp=false` |
| 学术研究引用特定语句 | `format=json`, `include_timestamp=true` |
| 翻译或 NLP 分析 | `format=text`, 去除时间戳获得干净文本 |
| 内容审核与事实核查 | 完整元数据 + 时间戳对齐原视频 |
显著优点
1. 即开即用：100 次免费额度无需绑定信用卡，邮箱验证即可开始
2. 格式灵活：JSON/Text 双模式，时间戳可开关，满足不同下游需求
3. 成本透明：仅成功请求计费，错误响应不扣额度
4. 速率充足：免费 tier 支持 300 次/分钟，足以应对批量处理
5. 自动化友好：纯 REST API，curl 即可调用，易于集成脚本与工作流
潜在局限与风险
| 问题 | 说明 |
|------|------|
| **依赖官方字幕** | 若视频未开启 CC 字幕或上传者未提供，返回 404 错误 |
| **自动字幕质量参差** | YouTube 自动生成的字幕可能存在识别错误，需人工校对 |
| **仅限 YouTube** | 不支持 Bilibili、TikTok 等其他平台 |
| **API 密钥本地存储** | 密钥写入 `~/.openclaw/openclaw.json`，虽自动备份但仍需防范本地泄露 |
| **第三方服务依赖** | 服务稳定性、定价策略变更不受终端用户控制 |
适合人群
- 内容创作者：快速整理访谈、播客、演讲稿
- 研究人员：建立可搜索的视频语料库，支持定性分析
- 翻译工作者：获取源文本进行多语言本地化
- 事实核查员：精确定位视频中的争议性言论
- 开发者：构建视频摘要、问答、内容监控等自动化流程
常规风险提示
- 隐私合规：提取的字幕可能含个人信息，处理时需遵守 GDPR 等法规
- 版权注意：字幕内容版权归原视频上传者，商用转载需获得授权
- 密钥安全：避免将
TRANSCRIPT_API_KEY硬编码在公开仓库或共享环境 - 额度监控：免费额度用尽后需付费充值，建议定期查看 transcriptapi.com/billing