名称： captions
描述： 从 YouTube 视频中提取隐藏式字幕和字幕。当用户询问字幕、隐藏式字幕、CC、无障碍文本或想了解视频内容时使用。支持时间戳和多种语言。适用于聋人/听障人士的无障碍访问、内容审核、引用和翻译。
主页： https://transcriptapi.com
user-invocable: true
元数据： {"openclaw":{"emoji":"💬","requires":{"env":["TRANSCRIPT_API_KEY"],"bins":["node"],"config":["~/.openclaw/openclaw.json"]},"primaryEnv":"TRANSCRIPT_API_KEY"}}

字幕提取

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

设置

如果未设置 $TRANSCRIPT_API_KEY，请协助用户创建账户（提供 100 个免费额度，无需绑定银行卡）：

步骤 1 — 注册： 向用户索取邮箱地址。

node ./scripts/tapi-auth.js register --email 用户邮箱

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

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

node ./scripts/tapi-auth.js verify --token 步骤1获取的令牌 --otp 验证码

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

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

文件写入

验证和保存密钥命令会将 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=视频URL&format=json&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

响应 (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 love\n[00:00:21] You know the rules..."
}

使用建议

• 使用 format=json 获取带同步信息的字幕（适用于无障碍工具、时间分析）。
• 使用 format=text 并设置 include_timestamp=false 可获得干净的阅读文本。
• 大多数视频提供自动生成的字幕；手动添加的 CC 字幕质量更高。

错误代码

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