API pro přepis: Přehled, autentizace a limity
Jak používat REST API VoxScriber: kdo má přístup, jak fungují klíče vpt_live_, autentizace Bearer, limity požadavků a účtování v cyklech.
REST API služby VoxScriber umožňuje posílat audio soubory přes URL a přijímat hotový přepis přímo do vašeho systému, bez nutnosti používat webové rozhraní. Používá stejné enginy a účtuje stejné cykly jako přepisy provedené v panelu.
Kdo má přístup
API je dostupná od plánu Profissional (R$ 39,90/měsíc). Přístup mají: Profissional, Premium, všechny plány Empresariais (měsíční i roční) a odpovídající starší plány. Pokud váš účet nemá nárok, endpointy klíčů vracejí chybu 403 PLAN_NOT_ELIGIBLE.
API klíče
Vytvořte klíč
Okamžitě si zkopírujte tajný klíč
vpt_live_... a zobrazí se pouze jednou, při vytvoření. My ukládáme pouze jeho hash – později jej nelze obnovit.Uložte bezpečně
Ztratili jste klíč? Nelze jej znovu zobrazit. Zneplatněte starý klíč a vytvořte nový. Kompromitované klíče je třeba okamžitě zneplatnit.
Vytváření osobních klíčů zatím nemá v panelu vyhrazenou obrazovku. Pokud má váš plán nárok a chcete API začít používat, otevřete ticket a tým vám přístup aktivuje.
Autentizace
Každý požadavek posílá klíč v hlavičce Authorization:
Authorization: Bearer vpt_live_SUA_CHAVE
Požadavek bez hlavičky vrátí 401 MISSING_API_KEY.
Odeslání audia k přepisu
Endpoint přepisu se nachází na bráně 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"]
}'
Přijímaná pole v těle: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER nebo ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata a idempotency_key. Výsledek dorazí na vaše webhook_url – viz Webhooky a notifikace.
Použijte idempotency_key s vaším identifikátorem (např. ID nahrávky ve vašem systému). Pokud bude stejný požadavek omylem odeslán znovu, zvuk se nezpracuje – ani neúčtuje – dvakrát.
Limity
| Limit | Hodnota |
|---|---|
| Požadavků na klíč | 60 za minutu |
| Audio stažené přes URL | až 500 MB (timeout 60 s) |
| Audio přes passthrough (engine Premium čte URL přímo) | až 5 GB |
| Aktivních klíčů na účet | 20 |
Bezpečnostní pravidla pro URL: pouze https, žádná přesměrování a interní/soukromé adresy jsou blokovány. URL zvuku musí být veřejně přístupná.
Dostupné exportní formáty se řídí rozsahem vašeho plánu, stejně jako na webu – formáty mimo plán se vrátí v seznamu exports_skipped.
Účtování
API strhává stejné cykly jako přepis provedený na webu, podle zvoleného enginu (Padrão/Whisper: 1 cyklus/min; Premium: 4 cykly/min; Ultra: 10 cyklů/min). V současnosti neexistuje měsíční kvóta volání ani strop výdajů na klíč – spotřebu kontrolujte podle svého zůstatku cyklů. Viz Co jsou cykly a kolik stojí každá minuta.
FAQ
Ztratil jsem API klíč. Jak ho obnovím?
Nejde ho obnovit – v databázi zůstává jen hash. Zneplatněte ztracený klíč a vytvořte si nový.
Je API dražší než web?
Ne. Náklad v cyklech je identický, určuje ho engine a délka zvuku.
Mohu poslat soubor přímo místo URL?
Hlavní způsob je přes audio_url. Pokud vaše audio soubory nemají veřejnou URL, kontaktujte podporu, abychom zvážili nejlepší postup pro váš případ.
Existuje dokumentace OpenAPI?
Veřejná specifikace v /.well-known/openapi.json v současnosti pokrývá pouze veřejné endpointy (statistiky a sdílené přepisy). Pro zbytek použijte tuto nápovědu a podporu.
Související články
- Webhooky a notifikace
- Automatizace s API
- Co jsou cykly a kolik stojí každá minuta
- Export do dalších nástrojů
Nevyřešeno? Otevřete ticket – náš tým odpovídá rychle.