YouTube Transcript API

Една заявка и имате цялата транскрипция. Плащате само за видеата, които изтеглите.

Бърз старт

Влезте и създайте API ключ в таблото на API. Получавате 10 безплатни кредита (5 транскрипции).
Изпратете ключа в заглавката X-API-Key заедно с URL адрес от 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: URL от YouTube (връзка watch, youtu.be, shorts, embed или live). Използвайте това или video_id.
video_id: 11-символното ID на видеото в YouTube.
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"

Цени

Всяка транскрипция струва 2 кредита. Кредитите не изтичат. Абонатите на Pro получават 100 бонус кредита всеки месец.

Пакет	Кредити	Транскрипции	Цена	На транскрипция
Starter	100	50	4,49 щ.д.	0,090 щ.д.
Pro	500	250	13,99 щ.д.	0,056 щ.д.
Scale	2000	1000	37,99 щ.д.	0,038 щ.д.
Business	5000	2500	74,99 щ.д.	0,030 щ.д.

Автоматично зареждане, бюджети и известия

Автоматичното зареждане купува пакет със запазената ви карта, когато балансът падне под избран от вас праг.
Месечният бюджет за зареждане ограничава колко може да похарчи автоматичното зареждане, а месечният лимит на кредити спира заявките, когато бъде достигнат.
Известията по имейл ви уведомяват, когато балансът е нисък, когато достигнете 80% от месечния лимит или когато зареждане не успее.

Лимити и честна употреба

60 заявки в минута на ключ, до 5 активни ключа на акаунт. API връща субтитри, които вече съществуват в YouTube; не транскрибира аудио. Вие отговаряте транскрипциите да се използват при спазване на правата на собствениците на видеата и условията на YouTube.

Често задавани въпроси

Плащам ли отново за същото видео?: Да, всяка успешна заявка струва 2 кредита, но повторните видеа се обслужват от нашия кеш за милисекунди.
Какво става, когато видеото няма субтитри?: Получавате грешка no_transcript и не се удържат кредити.
Съвместим ли е с други API за транскрипции?: Заявката и отговорът следват обичайната структура url, lang и segments, така че преминаването обикновено означава само смяна на базовия URL и ключа.