YouTube 字幕 API
一次請求，拿到完整字幕。只為獲取的影片付費。
免費獲取 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 和金鑰。