API da transcripziuns YouTube

Ina dumonda, l'entira transcripziun. Paja mo ils videos che ti retschaivas.

Entschatta svelta

S'annunzia e crea ina clav API sin il dashboard API. Ti retschaivas 10 credits gratuits (5 transcripziuns).
Tramette la clav en il header X-API-Key cun in URL da YouTube u in ID da video.
Cumpra in pachet da credits sche ti dovras dapli, u activescha la recarga automatica.

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

Dumonda

POST /api/v1/transcript

url: URL da YouTube (link watch, youtu.be, shorts, embed u live). Utilisescha quel u video_id.
video_id: L'ID da video da YouTube cun 11 caracters.
lang: Lingua preferida dals suttitels, per exempel en, de u pt-BR. Standard en. Sche quella lingua manca, vegn returnada la pista originala e la resposta inditgescha sia lingua effectiva.
format: json (segments cun marcas da temp, standard), text u 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();

Resposta

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

Errurs

401	invalid_key	Clav API mancanta, faussa u revocada.
400	invalid_input	L'URL u l'ID da video n'ha betg pudì vegnir legì.
402	insufficient_credits	Tes saldo è sut 2 credits.
402	budget_exceeded	Ti has cuntanschì il limit mensil da credits che ti has fixà.
404	no_transcript	Il video n'ha nagins suttitels, u el è privat, live u allontanà. Betg quintà.
429	rate_limited	Dapli che 60 dumondas per minuta cun ina clav. Spetga Retry-After secundas.
502	upstream_error	YouTube n'ha betg respundì a temp. Betg quintà, emprova pli tard.

Controllar il saldo

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

Pretschs

Mintga transcripziun custa 2 credits. Ils credits na scadan mai. Abunents Pro retschaivan 100 credits da bonus mintga mais.

Pachet	Credits	Transcripziuns	Pretsch	Per transcripziun
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 $

Recarga automatica, budgets ed avertiments

La recarga automatica cumpra in pachet cun tia carta memorisada cura che il saldo croda sut ina limita che ti tschernas.
In budget mensil da recarga limitescha quant che la recarga automatica po spender, ed in limit mensil da credits ferma las dumondas cura ch'el è cuntanschì.
Avertiments per e-mail ta infurmeschan cura che il saldo è bass, cura che ti cuntanschas 80% da tes limit mensil u cura che ina recarga na reussescha betg.

Limits ed utilisaziun gista

60 dumondas per minuta per clav, fin 5 clavs activas per conto. L'API returna suttitels che existan gia sin YouTube; ella na transcriva betg audio. Ti es responsabel d'utilisar las transcripziuns tenor ils dretgs dals possessurs dals videos e las cundiziuns da YouTube.

Dumondas frequentas

Pajel jau puspè per il medem video?: Gea, mintga dumonda reussida custa 2 credits, ma videos repetids vegnan respundids da noss cache en millisecundas.
Tge capita sch'in video n'ha nagins suttitels?: Ti retschaivas ina errur no_transcript e nagins credits na vegnan deducids.
È ella cumpatibla cun autras APIs da transcripziuns?: Dumonda e resposta suondan la furma usitada url, lang e segments, uschia che midar munta per il solit da midar l'URL da basa e la clav.