Automatisoi transkriptiot API:lla: käytännön esimerkkejä
Automaatio-ohjeita VoxScribern API:lla: lähetä tallenteet URL:n avulla, valitse moottori ja formaatit, käytä idempotency_key- ja metadata-kenttiä ja vastaanota kaikki webhookilla.
API:n avulla muutat minkä tahansa tallennelähteen — puhelinjärjestelmän, kokoustallentimen, sisäisen järjestelmän — haettavaksi tekstiksi ilman manuaalista työtä. Tämä artikkeli esittelee suositellun työnkulun ja valmiita reseptejä. Katso ennen aloitusta edellytykset kohdasta Transkriptio-API (Profissional+ -suunnitelma ja vpt_live_-avain).
Suositeltu työnkulku
- Lähetä ääni URL:n avulla
webhook_url-kentässä. - Vastaanota callback, kun käsittely on valmis (onnistuminen tai epäonnistuminen).
- Lataa viedyt tiedostot tuloslinkeistä — ne ovat voimassa 7 päivää.
Ei pollausta: kun rajoitus on 60 pyyntöä/minuutti avainta kohden, tilan jatkuva kysely syö kiintiötä. Webhook toimittaa lopputuloksen itsestään, jopa 6 uudelleenlähetystä, jos palvelimesi on alhaalla.
Resepti 1 — transkriboi jokainen uusi tallenne
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"
}'
metadatapalaa webhookissa — käytä sitä yhdistääksesi tuloksen oman järjestelmäsi tietueeseen.idempotency_keyvarmistaa, että vahingossa tapahtuvat uudelleenlähetykset (oman puolesi retry, deploy kesken työn) eivät käsittele eivätkä veloita samaa ääntä kahdesti.
Resepti 2 — valitse moottori kustannuksen mukaan
engine-kenttä hyväksyy arvot ASSEMBLYAI (Premium, oletus), WHISPER (Standard) ja ELEVENLABS (Ultra). Suurille volyymeille, joissa kustannus on tärkeämpi kuin viimeistely, käytä Whisperiä — 1 sykli/min verrattuna Premiumin 4:ään:
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Nyrkkisääntö: Premium tärkeisiin kokouksiin ja haastatteluihin; Standard (Whisper) suurille määrille ja meluiselle äänelle; Ultra, kun puhujien erottelun on oltava virheetöntä (saatavilla Profissional+ -suunnitelmassa).
Resepti 3 — automaattiset tekstitykset
Pyydä formats: ["srt", "vtt"] ja saat tekstitykset valmiina YouTubeen tai verkkoselaimen soittimiin suoraan webhookissa. Yksityiskohdat jokaisesta formaatista: Vienti muihin työkaluihin.
Rajoitukset, jotka vaikuttavat automaatioihin
| Nimike | Sääntö |
|---|---|
| Nopeusrajoitus | 60 pyyntöä/min avainta kohden |
audio_url | vain https, julkinen, enintään 500 MB (lataus) tai 5 GB passthrough-tilassa Premium-moottorilla |
| Formaatit | noudattavat suunnitelmasi rajoituksia; ei-sallitut palautetaan exports_skipped-kentässä |
| Latauslinkit | vanhenevat 7 päivässä (transkriptio säilyy arkistossa) |
| Syklit | samat hinnat kuin sivustolla, veloitetaan samasta saldosta |
Seuraa syklisaldoasi: tällä hetkellä avainkohtaista kulukattoa ei ole. Hallitsematon silmukka automaatiossa kuluttaa oikeaa saldoa. idempotency_key on ensimmäinen puolustuslinjasi.
FAQ
Miten saan lopullisen tekstin — webhookista vai pitääkö ladata?
Webhook tuo lopputuloksen ja linkit pyydettyihin tiedostoihin. Lataa tiedostot 7 päivän kuluessa; sen jälkeen sisältö on edelleen saatavilla sivuston arkistossa.
Voinko määrittää äänen kielen?
Kyllä, language-kentällä. Ilman sitä käytetään tilin oletuskieltä; automaattinen tunnistus on myös moottoreiden tukema.
Entä jos kaksi järjestelmää lähettää saman äänen?
Käytä samaa idempotency_key-arvoa molemmissa — vain ensimmäinen käsittelee ja veloittaa.
Toimiiko automaatio organisaation jäsenille?
Kyllä — ja kulutus noudattaa yrityksen suunnitelman sääntöjä. Laajamittaiseen puheluiden auditointiin katso erillistä API:ta.
Aiheeseen liittyvät artikkelit
Eikö ongelma ratkennut? Avaa tukipyyntö — tiimimme vastaa nopeasti.