Odeslat zvuk pomocí URL a API
Jak importovat zvuk pomocí přímé URL v rozhraní a jak posílat přepisy programově přes API: způsobilé plány, klíče, autentizace, limity a webhooky.
Kromě nahrávání souboru existují dva způsoby „bez souboru v ruce": vložit URL média do rozhraní (pro všechny uživatele) a poslat přes API (pro plány Profissional a vyšší) — ideální pro integraci přepisu do systémů, PABX a automatizací.
1. Import přes URL v rozhraní
Na obrazovce Nový přepis stejná volba, která přijímá YouTube, přijímá i přímé URL adresy zvukových/video souborů (https). Server stáhne médium a pokračuje běžným postupem: výběr jazyka (nebo automatická detekce), engine podle plánu a cena v cyklech podle délky. Limity délky a velikosti vašeho plánu platí stejně.
2. API pro přepis
Kdo může používat
API je k dispozici od plánu Profissional (R$ 39,90/měsíc) — včetně Premium, firemních plánů a odpovídajících starších plánů. U ostatních plánů vytvoření klíče vrátí, že plán není způsobilý.
API klíče
- Formát tokenu:
vpt_live_...; - Tajemství je zobrazeno pouze jednou, při vytvoření — uložte si ho do trezoru. Tajemství neukládáme, pouze jeho otisk;
- Až 20 aktivních klíčů na účet; kterýkoli z nich můžete kdykoli zrušit;
- Oblast správy osobních klíčů v rozhraní se teprve zavádí — pokud tuto možnost ve svém účtu nenajdete, otevřete ticket a my vám ji aktivujeme.
Jak funguje volání
Autentizace přes hlavičku Authorization: Bearer vpt_live_.... Do těla požadavku zadáte URL zvukového souboru (audio_url, pouze https), URL svého webhooku pro přijetí výsledku a volitelně engine, jazyk, exportní formáty a idempotentní klíč.
- Rate limit: 60 požadavků za minutu na klíč;
- Velikost: zvuk přes URL až 500 MB ke stažení na server; s enginem Premium lze URL až 5 GB číst přímo enginem, bez mezilehlého stahování;
- Cena: stejné cykly jako na webu, podle délky a enginu.
Obdržení výsledku (webhooky)
Výsledek dorazí webhookem podepsaným HMAC-SHA256 (hlavičky X-VPT-Signature a X-VPT-Event) — před tím, než payloadu důvěřujete, ověřte podpis. Pokud váš endpoint neodpovídá, posíláme znovu s postupným odstupem: až 6 pokusů během ~24 hodin.
Přijímáme pouze https URL a z bezpečnostních důvodů blokujeme interní/soukromé adresy. Pokud je váš zvuk chráněn autentizací, vygenerujte si v úložišti dočasnou podepsanou URL před voláním API.
Nemáte veřejnou URL pro soubor (např. záznamy z PABX)? Firemní auditorské API nabízí upload endpoint, který vrátí dočasnou URL pro nahrání (platnou 1 hodinu) — obraťte se na obchodní oddělení, pokud řešíte hromadnou auditaci hovorů.
Časté dotazy
Ztratil(a) jsem tajemství klíče. Jak ho obnovím?
Nejde ho obnovit — zrušte klíč a vytvořte nový. Tajemství existuje pouze při vytvoření.
Má API dokumentaci?
Kompletní referenci integrace obdržíte spolu s aktivací přístupu. Otevřete ticket a uveďte svůj případ použití.
Mohu v požadavku zvolit engine a jazyk?
Ano, oba jsou volitelné parametry — bez nich se použije výchozí engine plánu a detekce jazyka.
Účtuje API jinak než web?
Ne. Stejné cykly, stejná pravidla (včetně slevy až po úspěchu).
Jak zruším kompromitovaný klíč?
Okamžitě ho zrušte ve správě klíčů (nebo přes podporu). Zrušení ukončí přístup okamžitě.
Související články
Nevyřešili jsme váš problém? Otevřete ticket — tickety běžné priority odpovídáme do 24 hodin.