Automatizace přepisů pomocí API: Praktické příklady
Automatizace přepisů s API VoxScriber: posílejte nahrávky URL, vybírejte engine a formáty, použijte idempotency_key i metadata, výsledky přes webhook.
Pomocí API přeměníte jakýkoli zdroj nahrávek — telefonii, diktafon na schůzky, interní systém — na prohledávatelný text bez ručního zásahu. Tento článek přináší doporučený postup a hotové recepty. Nejprve se podívejte na předpoklady v API přepisu (plán Profissional+ a klíč vpt_live_).
Doporučený postup
- Pošlete zvuk pomocí URL s
webhook_url. - Obdržíte callback po dokončení (úspěch nebo chyba).
- Stáhnete exportované soubory z odkazů ve výsledku — platí 7 dní.
Žádné polling: při limitu 60 požadavků/minutu na klíč by dotazování na stav ve smyčce plýtvalo kvótou. Webhook doručí výsledek sám, s až 6 opětovnými doručeními, pokud váš server není dostupný.
Recept 1 — přepis všech nových nahrávek
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer $VPT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://storage.suaempresa.com/calls/2026-08-02-0931.mp3",
"webhook_url": "https://api.suaempresa.com/hooks/vpt",
"formats": ["txt", "docx"],
"metadata": { "call_id": "0931", "agente": "maria" },
"idempotency_key": "call-2026-08-02-0931"
}'
metadatase vrací ve webhooku — použijte ji ke korelaci výsledku se záznamem ve vašem systému.idempotency_keyzajišťuje, že náhodné opětovné odeslání (retry z vaší strany, deploy uprostřed úlohy) nezpracuje ani neúčtuje stejný zvuk dvakrát.
Recept 2 — výběr enginu podle ceny
Pole engine přijímá ASSEMBLYAI (Premium, výchozí), WHISPER (Standard) a ELEVENLABS (Ultra). Pro velký objem, kde cena záleží více než kvalita zpracování, použijte Whisper — 1 cyklus/min proti 4 u Premium:
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Pravidlo: Premium pro důležité schůzky a rozhovory; Standard (Whisper) pro velký objem a hlučné audio; Ultra, když oddělení mluvčích musí být bezchybné (dostupné v Profissional+).
Recept 3 — automatické titulky
Vyžádejte si formats: ["srt", "vtt"] a obdržíte hotové titulky pro YouTube nebo webové přehrávače přímo ve webhooku. Podrobnosti o jednotlivých formátech najdete v Export do dalších nástrojů.
Limity ovlivňující automatizace
| Položka | Pravidlo |
|---|---|
| Rate limit | 60 req/min na klíč |
audio_url | pouze https, veřejné, až 500 MB (download) nebo 5 GB přes passthrough s enginem Premium |
| Formáty | řídí se omezením vašeho plánu; nepovolené se vrátí v exports_skipped |
| Odkazy ke stažení | vyprší za 7 dní (přepis zůstává v archivu) |
| Cykly | stejné náklady jako na webu, odečítají se ze stejného zůstatku |
Sledujte svůj zůstatek cyklů: v současné době neexistuje strop výdajů na klíč. Automatizace s nekontrolovanou smyčkou spotřebovává skutečný zůstatek. idempotency_key je vaše první obranná linie.
FAQ
Jak obdržím konečný text — ve webhooku nebo si ho musím stáhnout?
Webhook přináší výsledek a odkazy na exportované soubory v požadovaných formátech. Soubory si stáhněte do 7 dnů; poté obsah zůstává dostupný v archivu na webu.
Mohu nastavit jazyk zvuku?
Ano, pomocí pole language. Bez něj platí výchozí nastavení účtu; automatická detekce je také podporována enginy.
Co když dva systémy pošlou stejný zvuk?
Použijte stejný idempotency_key v obou — zpracuje a naúčtuje se jen první.
Funguje automatizace pro členy organizace?
Ano — a spotřeba se řídí pravidly firemního plánu. Pro audit hovorů ve velkém měřítku viz vyhrazené API.
Související články
Nevyřešeno? Otevřete ticket — náš tým odpovídá rychle.