API транскрыпцый YouTube

Адзін запыт, поўная транскрыпцыя. Плаціце толькі за відэа, якія атрымліваеце.

Хуткі старт

Увайдзіце і стварыце 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: 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 $	0,090 $
Pro	500	250	13,99 $	0,056 $
Scale	2000	1000	37,99 $	0,038 $
Business	5000	2500	74,99 $	0,030 $

Аўтапапаўненне, бюджэты і апавяшчэнні

Аўтапапаўненне купляе пакет з захаванай карткі, калі баланс падае ніжэй за выбраны вамі парог.
Месячны бюджэт папаўнення абмяжоўвае выдаткі аўтапапаўнення, а месячны ліміт крэдытаў спыняе запыты пры яго дасягненні.
Апавяшчэнні па email паведамляюць, калі баланс нізкі, калі вы дасягнулі 80% месячнага ліміту або калі папаўненне не ўдалося.

Ліміты і сумленнае выкарыстанне

60 запытаў у хвіліну на ключ, да 5 актыўных ключоў на акаўнт. API вяртае субтытры, якія ўжо ёсць на YouTube; ён не распазнае аўдыя. Вы адказваеце за выкарыстанне транскрыпцый у адпаведнасці з правамі ўладальнікаў відэа і ўмовамі YouTube.

Пытанні і адказы

Ці плачу я зноў за тое ж відэа?: Так, кожны паспяховы запыт каштуе 2 крэдыты, але паўторныя відэа аддаюцца з нашага кэша за мілісекунды.
Што адбываецца, калі ў відэа няма субтытраў?: Вы атрымліваеце памылку no_transcript, і крэдыты не спісваюцца.
Ці сумяшчальны ён з іншымі API транскрыпцый?: Запыт і адказ прытрымліваюцца распаўсюджанай формы url, lang і segments, таму пераход звычайна азначае змену базавага URL і ключа.