字幕

通过以下方式从YouTube视频中提取隐藏字幕TranscriptAPI.com。

设置

如果$TRANSCRIPT_API_KEY未设置，则帮助用户创建账户（100免费积分，无需绑定银行卡）：

步骤 1 — 注册：向用户询问其邮箱。

node ./scripts/tapi-auth.js register --email USER_EMAIL

→ OTP将发送至邮箱。询问用户："请检查您的邮箱，获取6位验证码。"

步骤 2 — 验证：一旦用户提供了OTP：

node ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE

API密钥将保存至~/.openclaw/openclaw.json。详情请参见下方文件写入部分。修改前现有文件会进行备份。

手动选项：transcriptapi.com/signup→ 仪表板 → API密钥。

文件写入

verify 和 save-key 命令会将 API 密钥保存到~/.openclaw/openclaw.json（设置skills.entries.transcriptapi.apiKey和enabled: true）。修改前，现有文件会备份到~/.openclaw/openclaw.json.bak。

要在代理外的终端/CLI 中使用此 API 密钥，请手动添加到 shell 配置文件中：export TRANSCRIPT_API_KEY=<你的密钥>

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"

响应（格式=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": "..." }
}

• 开始：从视频开始计算的秒数
• 时长：字幕显示的持续时间

响应（格式=文本— 可读）：

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

提示

• 使用format=json获取带同步时间轴的字幕（适用于无障碍工具、时间分析）。
• 使用format=text并配合include_timestamp=false获取干净易读的文本。
• 大部分视频提供自动生成字幕；人工字幕质量更高。

错误代码

每次请求消耗1个积分。免费额度：100积分，每分钟300次请求。