DokumentacjaPlany, minuty i limity
Plany, minuty i limity
Poznaj plany i ceny. Sprawdź, jak liczymy minuty, kiedy korzystasz z doładowań i jakie limity obowiązują na koncie.
Za transkrypcje w transcript1 płacisz minutami nagrania. Każdy plan ma własną pulę minut i limity. Sprawdź, ile dostajesz w planie i jak działają doładowania.
Plany
| Free | Monthly | Annual | |
|---|---|---|---|
| Cena | $0, bez karty | $9 / miesiąc | $90 / rok |
| Minuty | 60 jednorazowo | 1000 / miesiąc | 1000 / miesiąc |
| Doładowania | Brak | $6 za 1000 minut | $5 za 1000 minut |
| Requesty na minutę | 30 | 200 | 300 |
| Aktywne transkrypcje | 2 | 10 | 20 |
Plan zmienisz, a minuty dokupisz w panelu na stronie „Billing”.
Ile minut zużyje nagranie
- Za każdą rozpoczętą minutę nagrania zużywasz 1 kredyt. Film trwający 61 sekund zużyje 2 minuty z puli. Minimalny koszt transkrypcji to 1 kredyt.
- Minuta kosztuje tyle samo niezależnie od źródła: YouTube, X, TikTok, Instagram, Facebook, Bluesky, inna obsługiwana platforma czy własny plik. Przy napisach z platformy mierzymy długość filmu, a przy zamianie mowy na tekst — długość audio. Napisy z YouTube i X rozliczamy tak samo jak napisy z TikToka i Bluesky.
- Jeśli ponownie zlecisz transkrypcję tego samego filmu, znów zużyjesz minuty. Ustaw
reuse_recent=true, żeby bez kolejnej opłaty pobrać swoją niedawną transkrypcję tego nagrania. Szczegóły znajdziesz w dokumentacji API. - Jeśli transkrypcja się nie uda albo ją anulujesz, nic nie płacisz. Minuty, które już pobraliśmy, oddajemy na konto.
Darmowe minuty
Na każdym koncie dostajesz jednorazowo 60 minut za darmo. Wystarczy potwierdzić e-mail. Przy rejestracji przez Google lub Microsoft dostajesz je od razu. Plan Free się nie odnawia. Jeśli nie potwierdzisz e-maila, POST /v1/transcriptions zwróci 403 email_not_verified.
Jak działają minuty w planie i doładowania
Korzystasz z dwóch pul minut:
- Minuty w planie odnawiają się na początku każdego cyklu. To, czego nie wykorzystasz, nie przechodzi na kolejny cykl. W Monthly i Annual dostajesz po 1000 minut miesięcznie.
- Minuty z doładowań kupujesz w pakietach po 1000 minut, od 1 do 20 pakietów naraz. Potrzebujesz do tego płatnego planu. Najpierw zużywasz minuty z planu, potem z doładowań. Doładowania nie wygasają, dopóki masz aktywny płatny plan.
Po anulowaniu płatnego planu wracasz do Free, bez puli minut z planu. Zachowujesz doładowania, ale skorzystasz z nich dopiero po ponownym włączeniu płatnego planu. Gdy przejdziesz z Free na płatny plan, pozostałe darmowe minuty dopiszemy do puli doładowań.
Jak sprawdzić saldo
Wywołaj GET /v1/account, żeby bezpłatnie sprawdzić saldo:
curl https://api.transcript1.com/v1/account \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"| Pole | Znaczenie |
|---|---|
minutes.remaining | Minuty dostępne teraz: cycle oraz topup, jeśli topup_usable ma wartość true. |
minutes.cycle | Ile minut zostało w bieżącym cyklu. |
minutes.topup | Ile minut masz z doładowań. |
minutes.topup_usable | Ma wartość true, gdy masz aktywny płatny plan. |
minutes.resets_at | Data odnowienia puli minut w planie albo null. |
limits | Limity requests_per_minute i max_active_jobs na twoim koncie. |
W odpowiedzi znajdziesz też plan i renews_at.
Gdy zabraknie minut, POST /v1/transcriptions zwróci 402 insufficient_minutes. Pole action_url prowadzi do strony „Billing”. Gdy saldo spadnie do 0, wyślemy ci też e-mail, najwyżej raz w cyklu.
Limity requestów
Limit jest wspólny dla całego konta: wszystkich kluczy API, sesji w panelu i połączeń MCP.
- Requesty na minutę: 30 w Free, 200 w Monthly i 300 w Annual. Liczymy je w oknach trwających minutę.
- Odpowiedź na każdy uwierzytelniony request do
/v1zawieraX-RateLimit-Limit(limit konta) iX-RateLimit-Remaining(ile requestów zostało w bieżącym oknie). - Jeśli przekroczysz limit, dostaniesz
429 rate_limited. NagłówekRetry-Afterpodaje, ile sekund zostało do następnego okna. - Przy wysyłaniu części pliku używasz tokenu uploadu. Te requesty nie zużywają limitu.
Ile transkrypcji może działać naraz
Do aktywnych transkrypcji zaliczamy te ze statusem queued, fetching lub transcribing. Możesz mieć ich jednocześnie 2 w Free, 10 w Monthly lub 20 w Annual. Jeśli spróbujesz uruchomić kolejną ponad limit, dostaniesz 429 too_many_active_jobs z nagłówkiem Retry-After. Poczekaj na zakończenie jednej z transkrypcji i spróbuj ponownie.
Upload w częściach ze statusem awaiting_upload nie zajmuje miejsca na aktywną transkrypcję. Zespół może jednak mieć najwyżej 20 otwartych uploadów. Po przekroczeniu tego limitu też dostaniesz 429 too_many_active_jobs. Gdy kończysz upload, transkrypcja trafia do kolejki. Sprawdzamy wtedy limit aktywnych transkrypcji.
Sprawdź opis błędów, żeby dobrać obsługę każdej odpowiedzi.
Ostatnia aktualizacja 14 października 2026