字幕

通过 TranscriptAPI.com 从 YouTube 视频中提取闭合字幕（Closed Captions）。

配置

若未设置环境变量 $TRANSCRIPT_API_KEY，请阅读 references/auth-setup.md 并按其中说明获取并保存该密钥。

必需请求头

每次请求均需包含以下两个请求头：

• Authorization（授权）：Bearer $TRANSCRIPT_API_KEY
• User-Agent（用户代理）：您的 agent 名称及版本号（如 HermesAgent/0.11.0、ClaudeCode/1.0）。版本号为可选字段，仅提供 agent 名称亦可。请勿省略此请求头，也不得使用空值或默认的通用 User-Agent —— 否则 Cloudflare 将返回 403 错误（错误码 1010）并拒绝请求。

GET /api/v2/youtube/transcript

curl -s "https://transcriptapi.com/api/v2/youtube/transcript
?video_url=VIDEO_URL&format=json&include_timestamp=true&send_metadata=true" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

响应示例（format=json —— 更适合无障碍访问与时间轴分析）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
  ],
  "metadata": { "title": "...", "author_name": "...", "thumbnail_url": "..." }
}

• start：字幕起始时间点，单位为距视频开头的秒数
• duration：该条字幕的显示时长（单位：秒）

响应示例（format=text —— 更易读）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to loven[00:00:21] You know the rules..."
}

使用建议

• 如需同步字幕（例如用于无障碍工具或时间轴分析），请使用 format=json。
• 如需简洁易读的纯文本字幕，请搭配使用 format=text 与 include_timestamp=false。
• 大多数视频支持自动生成字幕；手动添加的字幕（Manual CC）质量通常更高。

错误码

每次请求消耗 1 积分。免费套餐：100 积分，最高 300 次请求/分钟。