YouTube Transcript API

Jeden požadavek a máte celý přepis. Platíte jen za videa, která stáhnete.

Rychlý start

Přihlaste se a vytvořte API klíč v API přehledu. Dostanete 10 kreditů zdarma (5 přepisů).
Pošlete klíč v hlavičce X-API-Key spolu s URL YouTube nebo ID videa.
Když potřebujete víc, kupte balíček kreditů, nebo zapněte automatické dobíjení.

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

Požadavek

POST /api/v1/transcript

url: URL YouTube (odkaz watch, youtu.be, shorts, embed nebo live). Použijte toto, nebo video_id.
video_id: 11místné ID videa na YouTube.
lang: Preferovaný jazyk titulků, například en, de nebo pt-BR. Výchozí je en. Pokud jazyk chybí, vrátí se původní stopa a odpověď uvede její skutečný jazyk.
format: json (segmenty s časovými značkami, výchozí), text nebo 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();

Odpověď

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

Chyby

401	invalid_key	Chybějící, nesprávný nebo zrušený API klíč.
400	invalid_input	URL nebo ID videa nelze přečíst.
402	insufficient_credits	Váš zůstatek je nižší než 2 kredity.
402	budget_exceeded	Dosáhli jste měsíčního limitu kreditů, který jste nastavili.
404	no_transcript	Video nemá titulky, nebo je soukromé, živé či odstraněné. Neúčtuje se.
429	rate_limited	Více než 60 požadavků za minutu na jeden klíč. Počkejte počet sekund z Retry-After.
502	upstream_error	YouTube neodpověděl včas. Neúčtuje se, zkuste to později.

Zjistit zůstatek

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

Ceny

Každý přepis stojí 2 kredity. Kredity nikdy nevyprší. Předplatitelé Pro dostávají každý měsíc 100 bonusových kreditů.

Balíček	Kredity	Přepisy	Cena	Za přepis
Starter	100	50	4,49 US$	0,090 US$
Pro	500	250	13,99 US$	0,056 US$
Scale	2 000	1 000	37,99 US$	0,038 US$
Business	5 000	2 500	74,99 US$	0,030 US$

Automatické dobíjení, rozpočty a upozornění

Automatické dobíjení koupí balíček uloženou kartou, když zůstatek klesne pod vámi zvolenou hranici.
Měsíční rozpočet dobíjení omezuje, kolik může automatické dobíjení utratit, a měsíční limit kreditů zastaví požadavky, jakmile je dosažen.
E-mailová upozornění vám dají vědět, když dochází zůstatek, když dosáhnete 80 % měsíčního limitu nebo když dobití selže.

Limity a férové používání

60 požadavků za minutu na klíč, až 5 aktivních klíčů na účet. API vrací titulky, které už na YouTube existují; nepřepisuje zvuk. Odpovídáte za to, že přepisy používáte v souladu s právy vlastníků videí a podmínkami YouTube.

Časté dotazy

Platím znovu za stejné video?: Ano, každý úspěšný požadavek stojí 2 kredity, ale opakovaná videa obsloužíme z mezipaměti během milisekund.
Co se stane, když video nemá titulky?: Dostanete chybu no_transcript a kredity se neodečtou.
Je kompatibilní s jinými API pro přepisy?: Požadavek i odpověď mají obvyklou strukturu url, lang a segments, takže přechod obvykle znamená jen změnit základní URL a klíč.