YouTube транскрипт API
Бір сұрау жіберіп, толық транскриптті алыңыз. Тек алған бейнелеріңіз үшін төлейсіз.
Тегін 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 $ | 0,090 $ |
| Pro | 500 | 250 | 13,99 $ | 0,056 $ |
| Scale | 2 000 | 1 000 | 37,99 $ | 0,038 $ |
| Business | 5 000 | 2 500 | 74,99 $ | 0,030 $ |
Автотолтыру, бюджеттер және ескертулер
- Баланс сіз таңдаған шектен төмендегенде, автотолтыру сақталған картаңызбен пакет сатып алады.
- Айлық толтыру бюджеті автотолтыру шығынын шектейді, ал айлық кредит шегі жеткенде сұрауларды тоқтатады.
- Email ескертулері баланс азайғанда, айлық шектің 80%-на жеткенде немесе толтыру сәтсіз болғанда хабарлайды.
Шектеулер және әділ пайдалану
Кілт үшін минутына 60 сұрау, аккаунтқа 5 белсенді кілтке дейін. API YouTube-та бар субтитрлерді қайтарады; ол аудионы транскрипцияламайды. Транскрипттерді бейне иелерінің құқықтары мен YouTube шарттарына сай пайдалануға сіз жауаптысыз.
Жиі қойылатын сұрақтар
- Сол бейне үшін қайта төлеймін бе?
- Иә, әр сәтті сұрау 2 кредит тұрады, бірақ қайталанған бейнелер кэшімізден миллисекундта қайтарылады.
- Бейненің субтитрі болмаса не болады?
- no_transcript қатесін аласыз және кредит алынбайды.
- Басқа транскрипт API-лерімен үйлесімді ме?
- Сұрау мен жауап кең тараған url, lang және segments пішініне сай, сондықтан ауысу әдетте негізгі URL мен кілтті өзгертуді білдіреді.