Transcript

通过 TranscriptAPI.com 获取视频转录文本。

设置

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

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

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

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

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

bash
node ./scripts/tapi-auth.js verify --token 步骤1中的TOKEN --otp 验证码

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=true&sendmetadata=true \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

参数	必填	默认值	值
video_url	是	—	YouTube 链接或 11 位视频 ID
format

否 | json | json、text | | include_timestamp | 否 | true | true、false | | send_metadata | 否 | false | true、false |

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

默认设置： 除非用户另有指定，否则始终使用 format=text&includetimestamp=true&sendmetadata=true。

响应（format=json）：

json
{
video_id: dQw4w9WgXcQ,
language: en,
transcript: [
{ text: Were 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）：

json
{
video_id: dQw4w9WgXcQ,
language: en,
transcript: [00:00:18] Were no strangers to love\n[00:00:21] You know the rules...,
metadata: {...}
}

错误处理

状态码	含义	处理方式
401	API 密钥错误	检查密钥或重新设置
402

额度不足 | 前往 transcriptapi.com/billing 充值 | | 404 | 无转录文本 | 视频可能未启用字幕 | | 408 | 请求超时 | 等待 2 秒后重试一次 | | 429 | 请求频率限制 | 等待后重试 |

使用提示

• - 对于长视频，先总结关键点，根据用户请求提供完整转录文本。
• 需要精确时间戳引用特定时刻时，使用 format=json。
• 需要适合翻译或分析的纯文本时，使用 include_timestamp=false。
• 每次成功请求消耗 1 个额度。错误请求不消耗额度。
• 免费套餐：100 个额度，每分钟 300 次请求。