API ya manukuu ya YouTube

Ombi moja ndani, manukuu kamili nje. Lipia tu video unazopata.

Anza haraka

Ingia na uunde ufunguo wa API kwenye dashibodi ya API. Unapata mikopo 10 ya bure (manukuu 5).
Tuma ufunguo katika kichwa cha X-API-Key pamoja na URL ya YouTube au kitambulisho cha video.
Nunua kifurushi cha mikopo unapohitaji zaidi, au washa kujaza kiotomatiki.

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"}'

Ombi

POST /api/v1/transcript

url: URL ya YouTube (kiungo cha watch, youtu.be, shorts, embed au live). Tumia hii au video_id.
video_id: Kitambulisho cha video ya YouTube chenye herufi 11.
lang: Lugha unayopendelea ya manukuu, kwa mfano en, de au pt-BR. Chaguo-msingi ni en. Lugha hiyo isipokuwepo, wimbo asili unarudishwa na jibu linakuambia lugha yake halisi.
format: json (vipande vyenye alama za muda, chaguo-msingi), text au 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();

Jibu

{
  "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 }
  ]
}

Hitilafu

401	invalid_key	Ufunguo wa API haupo, si sahihi au umebatilishwa.
400	invalid_input	URL au kitambulisho cha video hakikuweza kusomwa.
402	insufficient_credits	Salio lako liko chini ya mikopo 2.
402	budget_exceeded	Umefikia kikomo cha mikopo cha kila mwezi ulichoweka.
404	no_transcript	Video haina manukuu, au ni ya faragha, mubashara au imeondolewa. Haitozwi.
429	rate_limited	Zaidi ya maombi 60 kwa dakika kwa ufunguo mmoja. Subiri sekunde za Retry-After.
502	upstream_error	YouTube haikujibu kwa wakati. Haitozwi, jaribu tena baadaye.

Angalia salio lako

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

Bei

Kila manukuu yanagharimu mikopo 2. Mikopo haiishi muda. Wanaojisajili Pro hupata mikopo 100 ya ziada kila mwezi.

Kifurushi	Mikopo	Manukuu	Bei	Kwa kila manukuu
Starter	100	50	US$ 4.49	US$ 0.090
Pro	500	250	US$ 13.99	US$ 0.056
Scale	2,000	1,000	US$ 37.99	US$ 0.038
Business	5,000	2,500	US$ 74.99	US$ 0.030

Kujaza kiotomatiki, bajeti na arifa

Kujaza kiotomatiki hununua kifurushi kwa kadi yako iliyohifadhiwa salio linaposhuka chini ya kiwango unachochagua.
Bajeti ya kujaza ya kila mwezi inaweka kikomo cha matumizi ya kujaza kiotomatiki, na kikomo cha mikopo cha kila mwezi kinasimamisha maombi kinapofikiwa.
Arifa za barua pepe hukujulisha salio linapokuwa chini, unapofikia 80% ya kikomo chako cha mwezi, au kujaza kunaposhindwa.

Vikomo na matumizi ya haki

Maombi 60 kwa dakika kwa kila ufunguo, hadi funguo 5 zinazotumika kwa kila akaunti. API inarudisha manukuu ambayo tayari yapo YouTube; hainukuu sauti. Una jukumu la kutumia manukuu kulingana na haki za wamiliki wa video na masharti ya YouTube.

Maswali ya kawaida

Je, nalipa tena kwa video ileile?: Ndiyo, kila ombi lililofanikiwa linagharimu mikopo 2, lakini video zinazorudiwa hujibiwa kutoka kwenye akiba yetu kwa milisekunde.
Nini hutokea video isipokuwa na manukuu?: Unapata hitilafu ya no_transcript na hakuna mikopo inayochukuliwa.
Je, inaendana na API nyingine za manukuu?: Ombi na jibu hufuata muundo wa kawaida wa url, lang na segments, kwa hiyo kubadili kwa kawaida ni kubadilisha URL ya msingi na ufunguo.