API transkrypcji YouTube

Jedno żądanie i masz pełną transkrypcję. Płacisz tylko za pobrane filmy.

Szybki start

Zaloguj się i utwórz klucz API w panelu API. Otrzymasz 10 darmowych kredytów (5 transkrypcji).
Wyślij klucz w nagłówku X-API-Key wraz z adresem URL YouTube lub ID filmu.
Kup pakiet kredytów, gdy potrzebujesz więcej, albo włącz automatyczne doładowanie.

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

Żądanie

POST /api/v1/transcript

url: URL YouTube (link watch, youtu.be, shorts, embed lub live). Użyj tego albo video_id.
video_id: 11-znakowy identyfikator filmu na YouTube.
lang: Preferowany język napisów, na przykład en, de lub pt-BR. Domyślnie en. Gdy tego języka brak, zwracana jest oryginalna ścieżka, a odpowiedź podaje jej rzeczywisty język.
format: json (segmenty ze znacznikami czasu, domyślnie), text lub 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();

Odpowiedź

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

Błędy

401	invalid_key	Brak klucza API, błędny lub unieważniony klucz.
400	invalid_input	Nie udało się odczytać adresu URL ani ID filmu.
402	insufficient_credits	Twoje saldo jest niższe niż 2 kredyty.
402	budget_exceeded	Osiągnięto ustawiony przez Ciebie miesięczny limit kredytów.
404	no_transcript	Film nie ma napisów albo jest prywatny, na żywo lub usunięty. Bez opłaty.
429	rate_limited	Ponad 60 żądań na minutę na jednym kluczu. Odczekaj liczbę sekund z Retry-After.
502	upstream_error	YouTube nie odpowiedział na czas. Bez opłaty, spróbuj później.

Sprawdź saldo

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

Cennik

Każda transkrypcja kosztuje 2 kredyty. Kredyty nigdy nie wygasają. Subskrybenci Pro otrzymują co miesiąc 100 kredytów bonusowych.

Pakiet	Kredyty	Transkrypcje	Cena	Za transkrypcję
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2000	1000	37,99 USD	0,038 USD
Business	5000	2500	74,99 USD	0,030 USD

Automatyczne doładowanie, budżety i alerty

Automatyczne doładowanie kupuje pakiet zapisaną kartą, gdy saldo spadnie poniżej wybranego przez Ciebie progu.
Miesięczny budżet doładowań ogranicza, ile może wydać automatyczne doładowanie, a miesięczny limit kredytów zatrzymuje żądania po jego osiągnięciu.
Alerty e-mail informują, gdy saldo jest niskie, gdy osiągniesz 80% miesięcznego limitu lub gdy doładowanie się nie powiedzie.

Limity i uczciwe korzystanie

60 żądań na minutę na klucz, do 5 aktywnych kluczy na konto. API zwraca napisy, które już istnieją na YouTube; nie transkrybuje dźwięku. Odpowiadasz za korzystanie z transkrypcji zgodnie z prawami właścicieli filmów i warunkami YouTube.

FAQ

Czy płacę ponownie za ten sam film?: Tak, każde udane żądanie kosztuje 2 kredyty, ale powtarzane filmy są obsługiwane z naszej pamięci podręcznej w milisekundach.
Co się dzieje, gdy film nie ma napisów?: Otrzymujesz błąd no_transcript i kredyty nie są pobierane.
Czy jest zgodne z innymi API transkrypcji?: Żądanie i odpowiedź mają typową strukturę url, lang i segments, więc zmiana zwykle oznacza tylko podmianę bazowego adresu URL i klucza.