Wysyłanie audio przez URL i API
Jak importować audio przez URL bezpośrednio w interfejsie oraz jak wysyłać transkrypcje programowo przez API: kwalifikujące się plany, klucze, autoryzacja, limity i webhooki.
Oprócz przesyłania plików istnieją dwa sposoby „bez pliku pod ręką”: wklejenie URL-a medium w interfejsie (dla każdego użytkownika) i wysyłanie przez API (dla planów Profissional i wyższych) — idealne do integracji transkrypcji z systemami, centralami PABX i automatyzacjami.
1. Importowanie przez URL w interfejsie
Na ekranie Nowa transkrypcja ta sama opcja, która akceptuje YouTube, akceptuje bezpośrednie adresy URL plików audio/wideo (https). Serwer pobiera nośnik i kontynuuje normalny proces: wybór języka (lub automatyczne wykrywanie), silnik planu i koszt w cyklach zależnie od czasu trwania. Limity czasu trwania i rozmiaru Twojego planu obowiązują tak samo.
2. API transkrypcji
Kto może używać
API jest dostępne od planu Profissional (R$ 39,90/mies.) — w tym Premium, plany firmowe i ich odpowiedniki w starszych wersjach. W innych planach próba utworzenia klucza zwraca informację, że plan nie kwalifikuje się.
Klucze API
- Format tokenu:
vpt_live_...; - Sekret jest wyświetlany tylko raz, podczas tworzenia — przechowaj go w bezpiecznym miejscu. Nie przechowujemy sekretu, a jedynie jego cyfrowy odcisk;
- Do 20 aktywnych kluczy na konto; możesz w dowolnym momencie cofnąć dowolny z nich;
- Obszar zarządzania kluczami osobistymi w interfejsie jest w trakcie wdrażania — jeśli nie znajdziesz tej opcji na swoim koncie, otwórz zgłoszenie, a my ją dla Ciebie aktywujemy.
Jak działa wywołanie
Uwierzytelnianie za pomocą nagłówka Authorization: Bearer vpt_live_.... W treści żądania podajesz URL audio (audio_url, tylko https), URL swojego webhooka do otrzymania wyniku oraz opcjonalnie silnik, język, formaty eksportu i klucz idempotencji.
- Limit żądań: 60 żądań na minutę na klucz;
- Rozmiar: audio przez URL do 500 MB do pobrania na serwer; z silnikiem Premium adresy URL do 5 GB mogą być odczytane bezpośrednio przez silnik, bez pośredniego pobierania;
- Koszt: te same cykle co w serwisie, zależnie od czasu trwania i silnika.
Otrzymywanie wyniku (webhooki)
Wynik przychodzi przez webhook podpisany za pomocą HMAC-SHA256 (nagłówki X-VPT-Signature i X-VPT-Event) — zweryfikuj podpis, zanim zaufasz ładunkowi. Jeśli Twój endpoint jest niedostępny, wysyłamy ponownie z wydłużającymi się odstępami: do 6 prób w ciągu ~24 godzin.
Akceptujemy wyłącznie URL-e https i blokujemy wewnętrzne/prywatne adresy ze względów bezpieczeństwa. Jeśli Twoje audio jest chronione uwierzytelnianiem, wygeneruj tymczasowy podpisany URL w swoim magazynie przed wywołaniem API.
Nie masz publicznego URL-a do pliku (np. nagrania z centrali PABX)? API audytowe dla firm oferuje endpoint przesyłania, który zwraca tymczasowy adres URL do wysłania (ważny 1 godzinę) — skontaktuj się z działem sprzedaży, jeśli Twój przypadek dotyczy audytu połączeń na dużą skalę.
Często zadawane pytania
Zgubiłem sekret klucza. Jak go odzyskać?
Nie można go odzyskać — cofnij klucz i utwórz nowy. Sekret istnieje tylko w momencie tworzenia.
Czy API ma dokumentację?
Tak, pełna dokumentacja integracji jest dostarczana wraz z aktywacją dostępu. Otwórz zgłoszenie i podaj swój przypadek użycia.
Czy w wywołaniu mogę wybrać silnik i język?
Tak, oba są parametrami opcjonalnymi — bez nich obowiązują domyślny silnik planu i wykrywanie języka.
Czy API kosztuje inaczej niż strona internetowa?
Nie. Te same cykle, te same zasady (w tym rabat tylko po powodzeniu).
Jak cofnąć skompromitowany klucz?
Cofnij go natychmiast w zarządzaniu kluczami (lub przez wsparcie). Cofnięcie natychmiast odcina dostęp.
Powiązane artykuły
Nie rozwiązaliśmy Twojego problemu? Otwórz zgłoszenie — zgłoszenia o normalnym priorytecie otrzymują odpowiedź w ciągu 24 godzin.