YouTube 자막 추출 API

요청 한 번에 전체 자막을. 가져온 동영상만큼만 결제하세요.

빠른 시작

로그인한 뒤 API 대시보드에서 API 키를 만드세요. 무료 10크레딧(자막 5건)을 드립니다.
YouTube URL 또는 동영상 ID와 함께 X-API-Key 헤더에 키를 담아 보내세요.
더 필요하면 크레딧 팩을 구매하거나 자동 충전을 켜세요.

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 URL(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	URL 또는 동영상 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"

요금

자막 1건은 2크레딧입니다. 크레딧은 만료되지 않습니다. Pro 구독자는 매달 보너스 100크레딧을 받습니다.

팩	크레딧	자막 수	가격	자막 1건당
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과 키만 바꾸면 됩니다.