API transkrypcji: przegląd, autoryzacja i limity
Jak korzystać z API REST VoxScriber: kto ma dostęp, jak działają klucze vpt_live_, autoryzacja Bearer, limity zapytań i rozliczanie cykli.
API REST VoxScriber umożliwia wysyłanie audio przez URL i odbieranie gotowej transkrypcji w Twoim systemie, bez przechodzenia przez stronę. Wykorzystuje te same silniki i nalicza te same cykle co transkrypcje wykonane w panelu.
Kto może korzystać
API jest dostępne od planu Profissional (R$ 39,90/mies.). Dostęp mają: Profissional, Premium, wszystkie plany Empresariais (miesięczne i roczne) oraz odpowiadające im plany starsze (legacy). Jeśli Twoje konto nie jest uprawnione, endpointy klucza zwracają błąd 403 PLAN_NOT_ELIGIBLE.
Klucze API
Utwórz klucz
Natychmiast skopiuj sekret
vpt_live_... i jest wyświetlany tylko raz, w momencie utworzenia. Przechowujemy wyłącznie jego hash — nie da się go później odzyskać.Przechowuj bezpiecznie
Zgubiłeś klucz? Nie ma możliwości ponownego wyświetlenia go. Zrewokuj stary klucz i utwórz nowy. Naruszone klucze należy natychmiast zrewokować.
Tworzenie kluczy osobistych nie ma jeszcze dedykowanego ekranu w panelu. Jeśli Twój plan jest uprawniony i chcesz zacząć korzystać z API, otwórz zgłoszenie, a zespół aktywuje dostęp z Tobą.
Uwierzytelnianie
Każde żądanie wysyła klucz w nagłówku Authorization:
Authorization: Bearer vpt_live_SUA_CHAVE
Żądanie bez nagłówka zwraca 401 MISSING_API_KEY.
Wysyłanie audio do transkrypcji
Endpoint transkrypcji znajduje się na bramie api.voxscriber.com:
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer vpt_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
"webhook_url": "https://seusistema.com/webhooks/vozparatexto",
"formats": ["txt", "srt"]
}'
Obsługiwane pola w ciele żądania: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER lub ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata i idempotency_key. Wynik trafia na Twój webhook_url — zobacz Webhooki i powiadomienia.
Użyj idempotency_key z własnym identyfikatorem (np. ID nagrania w Twoim systemie). Jeśli to samo żądanie zostanie przypadkowo wysłane ponownie, audio nie zostanie przetworzone — ani rozliczone — dwukrotnie.
Limity
| Limit | Wartość |
|---|---|
| Żądań na klucz | 60 na minutę |
| Audio pobierane przez URL | do 500 MB (limit czasu 60 s) |
| Audio przez passthrough (silnik Premium czyta URL bezpośrednio) | do 5 GB |
| Aktywne klucze na konto | 20 |
Zasady bezpieczeństwa URL: tylko https, bez przekierowań, a adresy wewnętrzne/prywatne są blokowane. URL audio musi być publicznie dostępny.
Dostępne formaty eksportu zależą od progu Twojego planu, tak samo jak na stronie — formaty spoza planu są zwracane na liście exports_skipped.
Rozliczenia
API nalicza te same cykle co transkrypcja wykonana na stronie, w zależności od wybranego silnika (Standard/Whisper: 1 cykl/min; Premium: 4 cykle/min; Ultra: 10 cykli/min). Obecnie nie ma miesięcznego limitu wywołań ani limitu wydatków na klucz — kontroluj zużycie przez swoje saldo cykli. Zobacz Czym są cykle i ile kosztuje każda minuta.
FAQ
Zgubiłem klucz API. Jak go odzyskać?
Nie można go odzyskać — w bazie zostaje tylko hash. Zrewokuj zgubiony klucz i utwórz nowy.
Czy API jest droższe niż strona?
Nie. Koszt w cyklach jest identyczny i zależy od silnika oraz długości audio.
Czy mogę wysłać plik bezpośrednio zamiast URL?
Głównym kanałem jest audio_url. Jeśli Twoje audio nie ma publicznego URL, skontaktuj się z pomocą, aby ustalić najlepszy przepływ dla Twojego przypadku.
Czy istnieje dokumentacja OpenAPI?
Publiczna specyfikacja w /.well-known/openapi.json obejmuje obecnie tylko publiczne endpointy (statystyki i udostępnione transkrypcje). W pozostałych przypadkach korzystaj z tej bazy wiedzy i pomocy.
Powiązane artykuły
- Webhooki i powiadomienia
- Automatyzacja z API
- Czym są cykle i ile kosztuje każda minuta
- Eksport do innych narzędzi
Nie rozwiązuje to problemu? Otwórz zgłoszenie — nasz zespół odpowiada szybko.