API аркылуу YouTube транскриптин кантип алса болот (curl, Python, JavaScript)

YouTube транскриптин API аркылуу алуу үчүн видеонун URL дарегин же ID'син жана API ачкычын камтыган бир HTTP сурамын жөнөт да, транскриптти жооптон оку. Бул колдонмо sum.video Transcript API аркылуу сурамды curl, Python жана JavaScript менен көрсөтөт, андан кийин форматтарды, каталарды жана баасын карайт.

API эмнени кайтарат

Акыркы чекит ачык YouTube видеосунун бар субтитрлерин кайтарат, аларды автор жазганбы же YouTube автоматтык түрдө түзгөнбү, айырмасы жок. Ал үндү транскрипциялабайт. Эгер видеодо субтитрлер жок болсо, божомолдун ордуна ката аласың (төмөндө кененирээк).

Негиздер:

• Акыркы чекит: POST https://sum.video/api/v1/transcript (GET дагы иштейт)
• Аутентификация: ачкычың X-API-Key башкы сабында же Authorization: Bearer <key>
• Киргизүү: url же video_id
• Милдеттүү эмес lang (демейки en)
• Милдеттүү эмес format: json, text же srt

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

1-кадам: API ачкычын түз

Кирип, API панелинде (/dashboard/api, sum.video сайтында) ачкыч түз. 5 чейин активдүү ачкычты кармасаң болот, бул сыноо ачкычын өндүрүш ачкычынан бөлүү үчүн ыңгайлуу. Биринчи ачкычың менен 10 акысыз кредит келет, бул 5 транскрипт үчүн жетиштүү, ошондуктан төмөнкүнүн баарын чыгымсыз сынап көрсөң болот.

2-кадам: Биринчи сурамыңды жөнөт

curl

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: $SUMVIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en", "format": "text"}'

GET дагы иштегендиктен, URL гана түзгөн скриптен сынасаң болот. Ачкыч журналдарга түшпөшү үчүн аны башкы сапта берген жакшы.

Python

import os
import requests

resp = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": os.environ["SUMVIDEO_API_KEY"]},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=30,
)

if resp.status_code == 404:
    print("No captions for this video")
else:
    resp.raise_for_status()
    print(resp.text)

JavaScript (Node 18+ же браузер)

const resp = 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({
    video_id: "dQw4w9WgXcQ",
    lang: "en",
    format: "text",
  }),
});

if (resp.status === 404) {
  console.log("No captions for this video");
} else if (!resp.ok) {
  throw new Error(`Request failed: ${resp.status}`);
} else {
  console.log(await resp.text());
}

Ачкычты серверде сакта. Браузер кодундагы ачкычты иштеп чыгуучу куралдарын ачкан ар бир адам көчүрүп алат.

3-кадам: Туура форматты тандоо

Эгер видеонун белгилүү учурунан шилтеме берүүнү пландасаң, json колдон жана шилтемени сегменттин offset маанисинен түз. LLM'ге берүү үчүн text кичине жана жөнөкөй. Кийин транскрипттин ичинен кол менен издегиң келсе, YouTube видеосунун транскриптинен кантип издөө керек бөлүмүн кара.

4-кадам: Тилди тандоо

lang демейки боюнча en. Аны каалаган тилиңе койгун, мисалы de же es. Жооп чындап кайтарылган трек тилин билдирет, ошондуктан болжобой, аны текшер. Видеодо көп учурда бир гана субтитр треги болот, ал эми API чыныгы субтитрлерди кайтарат, ошондуктан ал сенин ордуңа которбойт.

5-кадам: Каталарды иштет

Бул учурларды биринчи күндөн эске ал:

• 404 no_transcript: видеодо субтитрлер жок, же ал түз эфир, жеке видео же жок кылынган видео. Кайталай турган эч нерсе жок. Аны өткөрүп жибер же колдонуучудан башка видео сура.
• 402 budget_exceeded: өзүң койгон айлык кредит чегине жеттиң. Кийинки бөлүмдү кара.
• Ылдамдык чеги: ар бир ачкыч мүнөтүнө 60 сурамга уруксат берет. Топтомдук иштерди бөлүп жиберип, чектелгенде жайлат.
• Биздин тараптагы бузулуулар: кыска тыныгуудан кийин кайра аракет кыл. Алар эч нерсе турбайт.

Сервер каталарында кайталап, 404 болгондо өткөрүп жиберген жөнөкөй цикл өндүрүштүк муктаждыктардын көбүн жабат.

Канча турат

Ар бир транскрипт 2 кредит турат. Транскрипт кайтарбаган же sum.video тарабынан ишке ашпаган сурамдар эч нерсе турбайт, ошондуктан 404 эч качан калдыгыңды азайтпайт. Калдыкты GET /api/v1/credits аркылуу көрсөң болот.

Кредиттер эч качан мөөнөтү бүтпөгөн бир жолку пакеттер менен сатылат:

Pro жазылуучулары ар айда 100 бонус кредит да алышат. Оор жумуш үчүн, мисалы бүтүндөй каналды жүктөө үчүн, автоматтык толуктоо менен бюджеттерди камтыган чоң масштабдагы RAG колдонмосу үчүн YouTube транскрипттери сценарийин оку. Баалар бөлүмүн да кара.

Куруудан мурун билүүчү чектөөлөр

• Субтитрлери бар видеолор гана иштейт. Бул 404 no_transcript үчүн негизги себеп.
• Автоматтык түрдө түзүлгөн субтитрлерде каталар болушу мүмкүн, айрыкча ысымдарда, акценттерде жана техникалык терминдерде.
• API транскриптти гана кайтарат. Ал кыскача мазмун түзбөйт. Транскрипттин үстүнө кыскача мазмундар, убакыт белгилери жана чат кааласаң, муну YouTube жыйынтыктоочусу жасайт, ал эми транскрипт куралы бир видео үчүн кодсуз нускасы.
• Расмий YouTube Data API бул жерде алмаштыргыч эмес. Анын субтитрлерди жүктөө ыкмасы видеону түзөтүүгө уруксатты талап кылат, ошондуктан ал сенин өз видеолоруң үчүн (Google документтери).

Булактар

• YouTube Data API: Captions.download
• sum.video Transcript API