YouTube транскрипт 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: 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"

Баалар

Ар бир транскрипт 2 кредит турат. Кредиттердин мөөнөтү бүтпөйт. Pro жазылуучулар ай сайын 100 бонус кредит алышат.

Топтом	Кредиттер	Транскрипттер	Баа	Транскрипт үчүн
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2 000	1 000	37,99 USD	0,038 USD
Business	5 000	2 500	74,99 USD	0,030 USD

Автотолуктоо, бюджеттер жана эскертүүлөр

Баланс сиз тандаган чектен төмөндөгөндө автотолуктоо сакталган картаңыз менен топтом сатып алат.
Айлык толуктоо бюджети автотолуктоонун чыгымын чектейт, ал эми айлык кредит чеги жеткенде суроолорду токтотот.
Email эскертүүлөр баланс азайганда, айлык чектин 80%на жеткенде же толуктоо ишке ашпаганда кабарлайт.

Чектөөлөр жана адилет колдонуу

Ачкыч үчүн мүнөтүнө 60 суроо, аккаунтка 5ке чейин активдүү ачкыч. API YouTubeда мурунтан бар субтитрлерди кайтарат; ал аудиону транскрипциялабайт. Транскрипттерди видео ээлеринин укуктарына жана YouTube шарттарына ылайык колдонууга сиз жооптуусуз.

Көп берилүүчү суроолор

Ошол эле видео үчүн кайра төлөйүмбү?: Ооба, ар бир ийгиликтүү суроо 2 кредит турат, бирок кайталанган видеолор биздин кэштен миллисекунддарда кайтарылат.
Видеонун субтитри жок болсо эмне болот?: no_transcript катасын аласыз жана кредит алынбайт.
Башка транскрипт API менен шайкешпи?: Суроо жана жооп кеңири таралган url, lang жана segments формасына ылайык, ошондуктан өтүү адатта негизги URL менен ачкычты өзгөртүүнү билдирет.