YouTube Transcript API

Едно барање, целиот транскрипт. Плаќате само за видеата што ги преземате.

Брз почеток

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

Автоматско дополнување, буџети и предупредувања

Автоматското дополнување купува пакет со зачуваната картичка кога состојбата ќе падне под прагот што го избирате.
Месечниот буџет за дополнување ограничува колку може да потроши автоматското дополнување, а месечниот лимит на кредити ги запира барањата кога ќе се достигне.
Предупредувањата по е-пошта ве известуваат кога состојбата е ниска, кога ќе достигнете 80% од месечниот лимит или кога дополнувањето ќе пропадне.

Ограничувања и фер користење

60 барања во минута по клуч, до 5 активни клучеви по сметка. API враќа титлови што веќе постојат на YouTube; не транскрибира аудио. Вие сте одговорни транскриптите да ги користите во согласност со правата на сопствениците на видеата и условите на YouTube.

Чести прашања

Дали плаќам повторно за истото видео?: Да, секое успешно барање чини 2 кредити, но повторените видеа се служат од нашиот кеш за милисекунди.
Што се случува кога видеото нема титлови?: Добивате грешка no_transcript и не се одземаат кредити.
Дали е компатибилен со други API за транскрипти?: Барањето и одговорот ја следат вообичаената структура url, lang и segments, па преминувањето обично значи само промена на основниот URL и клучот.