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-а и кључа.