transcript

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Transcript

转录文本

Fetch video transcripts via TranscriptAPI.com.

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

Setup

配置步骤

$TRANSCRIPT_API_KEY

is not set, help the user create an account (100 free credits, no card):

Step 1 — Register: Ask user for their email.

bash

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

→ OTP sent to email. Ask user: "Check your email for a 6-digit verification code."

Step 2 — Verify: Once user provides the OTP:

bash

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

API key saved to your shell profile and agent config. Ready to use.

Manual option: transcriptapi.com/signup → Dashboard → API Keys.

如果未设置

$TRANSCRIPT_API_KEY

，请帮助用户创建账户（提供100个免费额度，无需绑定信用卡）：

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

bash

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

→ OTP已发送至邮箱。询问用户：“请查看邮箱获取6位验证码。”

步骤2 — 验证： 用户提供OTP后执行以下命令：

bash

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

API密钥已保存至你的Shell配置文件和Agent配置中，可直接使用。

手动配置选项：访问transcriptapi.com/signup → 控制台 → API密钥。

GET /api/v2/youtube/transcript

bash

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"

Param	Required	Default	Values
`video_url`	yes	—	YouTube URL or 11-char video ID
`format`	no	`json`	`json` , `text`
`include_timestamp`	no	`true`	`true` , `false`
`send_metadata`	no	`false`	`true` , `false`

Accepts: full URLs (

youtube.com/watch?v=ID

), short URLs (

youtu.be/ID

), shorts (

youtube.com/shorts/ID

), or bare video IDs.

Default: Always use

format=text&include_timestamp=true&send_metadata=true

unless user specifies otherwise.

Response (

format=json

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"
  }
}

Response (

format=text

json

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

bash

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"

参数名称	是否必填	默认值	可选值
`video_url`	是	—	YouTube链接或11位视频ID
`format`	否	`json`	`json` , `text`
`include_timestamp`	否	`true`	`true` , `false`
`send_metadata`	否	`false`	`true` , `false`

支持的视频标识类型：完整URL（

youtube.com/watch?v=ID

）、短链接（

youtu.be/ID

）、Shorts视频（

youtube.com/shorts/ID

），或直接传入11位视频ID。

默认配置： 除非用户特别指定，否则始终使用

format=text&include_timestamp=true&send_metadata=true

参数组合。

响应（
format=json
格式）：

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
格式）：

json

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

Errors

错误码说明

Code	Meaning	Action
401	Bad API key	Check key or re-setup
402	No credits	Top up at transcriptapi.com/billing
404	No transcript	Video may not have captions enabled
408	Timeout	Retry once after 2s
429	Rate limited	Wait and retry

状态码	错误含义	处理建议
401	API密钥无效	检查密钥或重新完成配置流程
402	额度不足	前往transcriptapi.com/billing页面充值
404	无转录文本	该视频可能未开启字幕功能
408	请求超时	等待2秒后重试一次
429	请求频率超限	等待一段时间后重试

Tips

使用提示

For long videos, summarize key points first, offer full transcript on request.
Use
```
format=json
```
when you need precise timestamps for quoting specific moments.
Use
```
include_timestamp=false
```
for clean text suitable for translation or analysis.
1 credit per successful request. Errors don't cost credits.
Free tier: 100 credits, 300 req/min.

对于长视频，先总结核心要点，用户明确要求时再提供完整转录文本。
当需要精准时间戳来引用特定片段时，使用
```
format=json
```
格式。
如果需要无时间戳的干净文本用于翻译或分析，设置
```
include_timestamp=false
```
。
每成功请求一次消耗1个额度，请求失败不扣除额度。
免费套餐：100个请求额度，每分钟最多允许300次请求。