YouTube Transcript API

Isang request lang, buong transcript na. Magbabayad ka lang para sa mga video na kinuha mo.

Mabilis na pagsisimula

1. Mag-sign in at gumawa ng API key sa API dashboard. Makakakuha ka ng 10 libreng credits (5 transcript).
2. Ipadala ang key sa X-API-Key header kasama ang YouTube URL o video ID.
3. Bumili ng credit pack kapag kailangan mo pa, o i-on ang awtomatikong top-up.

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

Request

POST /api/v1/transcript

• url: YouTube URL (watch, youtu.be, shorts, embed o live na link). Gamitin ito o ang video_id.
• video_id: Ang 11 character na YouTube video ID.
• lang: Gustong wika ng caption, halimbawa en, de o pt-BR. Default ay en. Kapag wala ang wikang iyon, ibinabalik ang orihinal na track at sinasabi ng sagot ang tunay na wika nito.
• format: json (mga segment na may timestamp, default), text o 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();

Sagot

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

Mga error

Tingnan ang balanse mo

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

Presyo

Bawat transcript ay 2 credits. Hindi nag-e-expire ang credits. Ang mga Pro subscriber ay may 100 bonus credits bawat buwan.

Awtomatikong top-up, budget at alerto

• Bumibili ng pack ang awtomatikong top-up gamit ang naka-save mong card kapag bumaba ang balanse sa threshold na pinili mo.
• Nililimitahan ng buwanang top-up budget kung magkano ang magagastos ng awtomatikong top-up, at pinahihinto ng buwanang limitasyon ng credits ang mga request kapag naabot ito.
• Inaabisuhan ka ng mga email alert kapag mababa na ang balanse, kapag naabot mo ang 80% ng buwanang limitasyon, o kapag pumalya ang isang top-up.

Mga limitasyon at patas na paggamit

60 request bawat minuto bawat key, hanggang 5 aktibong key bawat account. Ibinabalik ng API ang mga caption na nasa YouTube na; hindi nito tina-transcribe ang audio. Ikaw ang responsable na gamitin ang mga transcript ayon sa karapatan ng mga may-ari ng video at sa mga tuntunin ng YouTube.

FAQ

Magbabayad ba ako ulit para sa parehong video?

Oo, 2 credits ang bawat matagumpay na request, pero ang mga paulit-ulit na video ay sinasagot mula sa aming cache sa loob ng ilang millisecond.

Ano ang mangyayari kapag walang caption ang video?

Makakakuha ka ng no_transcript na error at walang credits na ibabawas.

Compatible ba ito sa ibang transcript API?

Sumusunod ang request at sagot sa karaniwang istruktura ng url, lang at segments, kaya kadalasan base URL at key lang ang kailangang palitan.