字幕

通过 TranscriptAPI.com 获取 YouTube 视频字幕。

设置

如果未设置 $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=text&include_timestamp=false&send_metadata=true" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

语言学习场景 —— 获取不含时间戳的干净文本：

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

翻译场景 —— 获取结构化分段（含时间戳）：

curl -s "https://transcriptapi.com/api/v2/youtube/transcript
?video_url=VIDEO_ID&format=json&include_timestamp=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 }
  ]
}

响应示例（format=text，且 include_timestamp=false）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "We're no strangers to lovenYou know the rules and so do I..."
}

使用提示

• 许多视频提供多种语言的自动生成字幕。
• 使用 format=json 可获取每行字幕对应的时间戳（适合同步阅读）。
• 使用 include_timestamp=false 可获得适合翻译类应用使用的干净纯文本。

错误码

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