核心用法
Subtitles Skill 通过 TranscriptAPI.com 接口获取 YouTube 视频字幕，主要服务于三类场景：
1. 语言学习：获取纯文本字幕（format=text&include_timestamp=false），去除时间戳干扰，便于阅读、词汇提取或导入学习应用
2. 同步阅读：获取带时间戳的 JSON 格式（format=json&include_timestamp=true），实现逐句跟读或时间轴对照
3. 内容翻译：结构化字幕数据可直接送入翻译工作流，保留段落完整性
认证流程
技能采用 API Key 认证（TRANSCRIPT_API_KEY），支持引导式自动注册：用户提供邮箱 → 系统生成密码 → 邮件验证 OTP → 自动保存密钥。也支持手动在官网注册。
计费模式
按请求计费（1 credit/次），免费额度 100 credits，速率限制 300 req/min。
显著优点
- 开箱即用：内置完整的注册引导脚本，降低使用门槛
- 格式灵活：text/json 双格式，时间戳可开关，适配不同下游场景
- 多语言支持：自动获取视频可用字幕语言，包括自动生成字幕
- 元数据丰富：可选返回视频标题、频道、描述，便于内容管理
潜在缺点与局限性
- 依赖第三方服务：TranscriptAPI.com 为商业 API，存在服务可用性和定价变动风险
- 非官方 YouTube API：通过非官方渠道抓取字幕，YouTube 反爬策略变化可能导致失效
- 免费额度有限：100 credits 仅支持约 100 个视频，后续需付费（$5/1000 credits 起）
- 无实时字幕：不支持直播或实时生成字幕，仅处理已存在字幕
- 地区限制内容：部分区域限制或私人视频无法获取
适合人群
- 语言学习者（需要大量视频文本素材）
- 内容创作者/翻译者（批量处理视频字幕）
- 研究人员（视频内容分析、语料收集）
- 无障碍需求用户（将视频转为可读文本）
常规风险
- API 密钥泄露：
TRANSCRIPT_API_KEY需妥善保管，泄露可能导致额度被盗刷 - 隐私合规：获取他人视频字幕需注意版权和隐私边界，商业用途建议确认授权
- 服务中断风险：非官方抓取依赖第三方维护，长期稳定性弱于官方 YouTube Data API（尽管后者无免费字幕端点）
- 成本失控：批量处理大量视频时需注意 credits 消耗，建议设置用量监控