字幕

通过以下方式获取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=text&include_timestamp=false&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

用于语言学习—— 不含时间戳的纯文本：

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

用于翻译—— 结构化分段：

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

响应(格式=文本,包含时间戳=否):

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

提示

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

错误代码

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