API de transcrieri YouTube

O cerere, transcrierea completă. Plătești doar videoclipurile pe care le preiei.

Pornire rapidă

Conectează-te și creează o cheie API în panoul API. Primești 10 credite gratuite (5 transcrieri).
Trimite cheia în antetul X-API-Key împreună cu un URL YouTube sau un ID de videoclip.
Cumpără un pachet de credite când ai nevoie de mai multe sau activează reîncărcarea automată.

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

Cerere

POST /api/v1/transcript

url: URL YouTube (link watch, youtu.be, shorts, embed sau live). Folosește acesta sau video_id.
video_id: ID-ul de 11 caractere al videoclipului YouTube.
lang: Limba preferată a subtitrărilor, de exemplu en, de sau pt-BR. Implicit en. Dacă limba lipsește, se returnează pista originală, iar răspunsul indică limba reală.
format: json (segmente cu marcaje de timp, implicit), text sau 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();

Răspuns

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

Erori

401	invalid_key	Cheie API lipsă, greșită sau revocată.
400	invalid_input	URL-ul sau ID-ul videoclipului nu a putut fi citit.
402	insufficient_credits	Soldul tău este sub 2 credite.
402	budget_exceeded	Ai atins limita lunară de credite pe care ai setat-o.
404	no_transcript	Videoclipul nu are subtitrări sau este privat, live ori șters. Nu se taxează.
429	rate_limited	Peste 60 de cereri pe minut cu o cheie. Așteaptă numărul de secunde din Retry-After.
502	upstream_error	YouTube nu a răspuns la timp. Nu se taxează, încearcă mai târziu.

Verifică soldul

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

Prețuri

Fiecare transcriere costă 2 credite. Creditele nu expiră niciodată. Abonații Pro primesc 100 de credite bonus în fiecare lună.

Pachet	Credite	Transcrieri	Preț	Per transcriere
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2.000	1.000	37,99 USD	0,038 USD
Business	5.000	2.500	74,99 USD	0,030 USD

Reîncărcare automată, bugete și alerte

Reîncărcarea automată cumpără un pachet cu cardul salvat când soldul scade sub un prag ales de tine.
Un buget lunar de reîncărcare limitează cât poate cheltui reîncărcarea automată, iar o limită lunară de credite oprește cererile când este atinsă.
Alertele pe e-mail te anunță când soldul e scăzut, când atingi 80% din limita lunară sau când o reîncărcare eșuează.

Limite și utilizare corectă

60 de cereri pe minut per cheie, până la 5 chei active per cont. API-ul returnează subtitrări care există deja pe YouTube; nu transcrie audio. Ești responsabil să folosești transcrierile respectând drepturile proprietarilor videoclipurilor și termenii YouTube.

Întrebări frecvente

Plătesc din nou pentru același videoclip?: Da, fiecare cerere reușită costă 2 credite, dar videoclipurile repetate sunt servite din cache-ul nostru în milisecunde.
Ce se întâmplă când un videoclip nu are subtitrări?: Primești eroarea no_transcript și nu se scad credite.
Este compatibil cu alte API-uri de transcrieri?: Cererea și răspunsul urmează structura obișnuită url, lang și segments, așa că trecerea înseamnă de obicei doar schimbarea URL-ului de bază și a cheii.