转录

通过以下方式获取视频转录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"

接受：完整网址（youtube.com/watch?v=ID）、短网址（youtu.be/ID）、短视频（youtube.com/shorts/ID）或纯视频ID。

默认：始终使用format=text&include_timestamp=true&send_metadata=true除非用户另有指定。

响应(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": "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"
  }
}

响应(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...",
  "metadata": {...}
}

错误

提示

• 对于长视频，先总结要点，可应要求提供完整文字稿。
• 使用format=json格式，以便在需要引用特定时刻时获得精确的时间戳。
• 使用include_timestamp=false参数，以获得适用于翻译或分析的纯净文本。
• 每次成功请求消耗1个积分。错误不计费。
• 免费额度：100积分，每分钟300次请求。