YouTube 字幕 API

一次请求，拿到完整字幕。只为获取的视频付费。

快速开始

登录后在 API 控制台创建 API 密钥。你将获得 10 个免费积分（5 份字幕）。
在 X-API-Key 请求头中发送密钥，并附上 YouTube 链接或视频 ID。
需要更多时购买积分包，或开启自动充值。

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: sv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'

请求

POST /api/v1/transcript

url: YouTube 链接（watch、youtu.be、shorts、embed 或 live 链接）。使用此项或 video_id。
video_id: 11 个字符的 YouTube 视频 ID。
lang: 首选字幕语言，例如 en、de 或 pt-BR。默认为 en。如果没有该语言，将返回原始字幕轨道，并在响应中注明其实际语言。
format: json（带时间戳的片段，默认）、text 或 srt。

import requests

response = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": "sv_live_your_key"},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=120,
)
print(response.json()["text"])

const response = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();

响应

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "is_generated": false,
  "credits_used": 2,
  "credits_remaining": 98,
  "segments": [
    { "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
  ]
}

错误

401	invalid_key	API 密钥缺失、错误或已撤销。
400	invalid_input	无法识别链接或视频 ID。
402	insufficient_credits	余额不足 2 积分。
402	budget_exceeded	已达到你设置的月度积分上限。
404	no_transcript	该视频没有字幕，或为私密、直播中或已删除。不收费。
429	rate_limited	单个密钥每分钟请求超过 60 次。请等待 Retry-After 指定的秒数。
502	upstream_error	YouTube 未及时响应。不收费，请稍后重试。

查询余额

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

价格

每份字幕 2 积分。积分永不过期。Pro 订阅用户每月获赠 100 积分。

套餐	积分	字幕份数	价格	每份字幕
Starter	100	50	US$4.49	US$0.090
Pro	500	250	US$13.99	US$0.056
Scale	2,000	1,000	US$37.99	US$0.038
Business	5,000	2,500	US$74.99	US$0.030

自动充值、预算和提醒

当余额低于你设定的阈值时，自动充值会用已保存的银行卡购买一个积分包。
月度充值预算限制自动充值的支出上限，月度积分上限达到后会停止请求。
余额不足、用量达到月度上限的 80% 或充值失败时，我们会发邮件通知你。

限制与合理使用

每个密钥每分钟 60 次请求，每个账户最多 5 个有效密钥。API 返回 YouTube 上已有的字幕，不会转写音频。你须确保对字幕的使用符合视频所有者的权利和 YouTube 条款。

常见问题

同一个视频会重复收费吗？: 会，每次成功请求消耗 2 积分，但重复的视频会在数毫秒内从缓存返回。
视频没有字幕会怎样？: 你会收到 no_transcript 错误，不会扣除积分。
它兼容其他字幕 API 吗？: 请求和响应采用常见的 url、lang 和 segments 结构，切换时通常只需更换基础 URL 和密钥。