API lấy phụ đề YouTube

Một yêu cầu, nhận ngay toàn bộ bản ghi. Chỉ trả tiền cho những video bạn lấy.

Bắt đầu nhanh

Đăng nhập và tạo khóa API trên bảng điều khiển API. Bạn nhận 10 tín dụng miễn phí (5 bản ghi).
Gửi khóa trong header X-API-Key cùng với URL YouTube hoặc ID video.
Mua gói tín dụng khi cần thêm, hoặc bật tự động nạp.

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

Yêu cầu

POST /api/v1/transcript

url: URL YouTube (liên kết watch, youtu.be, shorts, embed hoặc live). Dùng trường này hoặc video_id.
video_id: ID video YouTube gồm 11 ký tự.
lang: Ngôn ngữ phụ đề mong muốn, ví dụ en, de hoặc pt-BR. Mặc định là en. Nếu thiếu ngôn ngữ đó, bản gốc sẽ được trả về và phản hồi cho biết ngôn ngữ thực của nó.
format: json (các đoạn kèm mốc thời gian, mặc định), text hoặc 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();

Phản hồi

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

Lỗi

401	invalid_key	Thiếu, sai hoặc đã thu hồi khóa API.
400	invalid_input	Không đọc được URL hoặc ID video.
402	insufficient_credits	Số dư của bạn dưới 2 tín dụng.
402	budget_exceeded	Bạn đã đạt giới hạn tín dụng hằng tháng mà bạn đặt.
404	no_transcript	Video không có phụ đề, hoặc ở chế độ riêng tư, đang phát trực tiếp hay đã bị xóa. Không tính phí.
429	rate_limited	Hơn 60 yêu cầu mỗi phút trên một khóa. Hãy đợi số giây trong Retry-After.
502	upstream_error	YouTube không phản hồi kịp. Không tính phí, hãy thử lại sau.

Kiểm tra số dư

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

Bảng giá

Mỗi bản ghi tốn 2 tín dụng. Tín dụng không bao giờ hết hạn. Người đăng ký Pro nhận 100 tín dụng thưởng mỗi tháng.

Gói	Tín dụng	Bản ghi	Giá	Mỗi bản ghi
Starter	100	50	4,49 US$	0,090 US$
Pro	500	250	13,99 US$	0,056 US$
Scale	2.000	1.000	37,99 US$	0,038 US$
Business	5.000	2.500	74,99 US$	0,030 US$

Tự động nạp, ngân sách và cảnh báo

Tự động nạp sẽ mua một gói bằng thẻ đã lưu khi số dư giảm xuống dưới ngưỡng bạn chọn.
Ngân sách nạp hằng tháng giới hạn số tiền tự động nạp được chi, còn giới hạn tín dụng hằng tháng sẽ dừng yêu cầu khi đạt tới.
Cảnh báo qua email cho bạn biết khi số dư thấp, khi bạn đạt 80% giới hạn tháng hoặc khi một lần nạp thất bại.

Giới hạn và sử dụng hợp lý

60 yêu cầu mỗi phút cho mỗi khóa, tối đa 5 khóa đang hoạt động mỗi tài khoản. API trả về phụ đề đã có trên YouTube; API không chuyển âm thanh thành văn bản. Bạn chịu trách nhiệm sử dụng bản ghi phù hợp với quyền của chủ sở hữu video và điều khoản của YouTube.

Câu hỏi thường gặp

Tôi có phải trả lại tiền cho cùng một video không?: Có, mỗi yêu cầu thành công tốn 2 tín dụng, nhưng video lặp lại được trả về từ bộ nhớ đệm của chúng tôi chỉ trong vài mili giây.
Điều gì xảy ra khi video không có phụ đề?: Bạn nhận lỗi no_transcript và không bị trừ tín dụng.
API có tương thích với các API phụ đề khác không?: Yêu cầu và phản hồi theo cấu trúc phổ biến url, lang và segments, nên chuyển đổi thường chỉ cần đổi URL gốc và khóa.