字幕

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

设置

如果未设置 $TRANSCRIPTAPIKEY，请帮助用户创建账户（100 个免费额度，无需信用卡）：

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

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

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

步骤 2 — 验证： 用户提供验证码后：

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

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

手动操作方式：transcriptapi.com/signup → 控制面板 → API 密钥。

文件写入

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

要在代理之外的终端/命令行中使用 API 密钥，请手动添加到您的 shell 配置文件中：
export TRANSCRIPTAPIKEY=

GET /api/v2/youtube/transcript

bash
curl -s https://transcriptapi.com/api/v2/youtube/transcript\
?videourl=VIDEOURL&format=text&includetimestamp=false&sendmetadata=true \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

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

bash
curl -s https://transcriptapi.com/api/v2/youtube/transcript\
?videourl=VIDEOID&format=text&include_timestamp=false \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

用于翻译 — 结构化片段：

bash
curl -s https://transcriptapi.com/api/v2/youtube/transcript\
?videourl=VIDEOID&format=json&include_timestamp=true \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

响应（format=json）：

json
{
video_id: dQw4w9WgXcQ,
language: en,
transcript: [
{ text: Were no strangers to love, start: 18.0, duration: 3.5 }
]
}

响应（format=text、include_timestamp=false）：

json
{
video_id: dQw4w9WgXcQ,
language: en,
transcript: Were no strangers to love\nYou know the rules and so do I...
}

提示

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

错误

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