视频转录

通过以下方式从视频中提取转录文本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=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

接受的URL格式：

• https://www.youtube.com/watch?v=视频ID
• https://youtu.be/视频ID
• https://youtube.com/shorts/视频ID
• 纯视频ID：dQw4w9WgXcQ

响应（format=text&send_metadata=true）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
  "metadata": {
    "title": "Rick Astley - Never Gonna Give You Up",
    "author_name": "Rick Astley",
    "author_url": "https://www.youtube.com/@RickAstley",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
}

响应(格式=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 }
  ]
}

提示

• 首先将长文本记录总结为关键点，根据请求提供完整文本。
• 使用格式=json当您需要精确的时间戳来引用特定时刻时。
• 使用发送元数据=true以获取视频标题和频道信息作为上下文。
• 也适用于YouTube Shorts。

错误

每次成功请求消耗1积分。错误不消耗积分。免费额度：100积分，每分钟300次请求。