核心用法
subtitles 技能通过 TranscriptAPI.com 服务获取 YouTube 视频的字幕内容，支持两种输出格式：
- JSON 格式：带时间戳的分段字幕，适合同步阅读、视频编辑
- 纯文本格式：干净无时间戳的连续文本，适合翻译工具导入、语言学习
使用方式简单，仅需提供 YouTube URL 或视频 ID，通过 API 密钥认证后即可调用。
显著优点
1. 多语言支持：可提取视频自带的多语言字幕（含自动生成的 CC 字幕）
2. 格式灵活：include_timestamp 参数自由切换时间戳，适配不同场景
3. 元数据完整：可选返回视频标题、频道、描述信息
4. 成本友好：免费 100 积分起步，无信用卡门槛，单价 1 积分/请求
5. 高并发：免费 tier 支持 300 请求/分钟
潜在缺点与局限性
- 依赖第三方 API：TranscriptAPI.com 为商业服务，长期稳定性受服务商运营影响
- 字幕可用性受限：部分视频无字幕、字幕被上传者禁用或仅限特定语言
- 错误码需手动处理：402（额度耗尽）、404（无字幕）、408（超时）需用户介入
- 仅支持 YouTube：不覆盖 Bilibili、Vimeo 等其他平台
- 自动字幕质量参差：依赖 YouTube 的 ASR 准确率，专业术语、口音场景可能失真
适合人群
- 语言学习者：提取目标语言视频文本进行词汇整理
- 翻译工作者：获取源文本进行快速译前准备
- 内容研究者：批量获取视频转写文本做语义分析
- 无障碍需求用户：将视频内容转为可读文本
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `TRANSCRIPT_API_KEY` 需妥善保管，泄露可能导致额度被盗刷 |
| 隐私合规 | 提取视频字幕需注意原内容的版权与使用授权 |
| 服务中断 | 第三方 API 可能调整定价或终止服务，建议备份关键流程 |
| 数据准确性 | 自动字幕存在错漏，关键场景建议人工校对 |