Automatiser transkripsjoner med API-en: Praktiske eksempler
Automatiseringsoppskrifter med VoxScriber API: send opptak via URL, velg engine og formater, bruk idempotency_key og metadata, og motta alt via webhook.
Med API-en kan du gjøre om enhver kilde til opptak — telefoni, møteopptaker, internt system — til søkbar tekst uten manuelt arbeid. Denne artikkelen viser anbefalt flyt og ferdige oppskrifter. Se først forutsetningene i transkripsjons-API (Profissional+-planen og nøkkel vpt_live_).
Anbefalt flyt
- Send lyden via en URL med
webhook_url. - Motta callbacket når det er ferdig (suksess eller feil).
- Last ned de eksporterte filene via lenkene i resultatet — de er gyldige i 7 dager.
Ingen polling: med en grense på 60 forespørsler/minutt per nøkkel, kaster du bort kvoten ved å sjekke status i en løkke. Webhooken leverer utfallet selv, med opptil 6 nye leveranser hvis serveren din er nede.
Oppskrift 1 — transkriber hvert nye opptak
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"
}'
metadatakommer tilbake i webhooken — bruk den til å korrelere resultatet med posten i systemet ditt.idempotency_keysikrer at utilsiktede forsendelser (retry fra din side, deploy midt i jobben) ikke behandler eller fakturerer den samme lyden to ganger.
Oppskrift 2 — velg engine basert på kostnad
Feltet engine godtar ASSEMBLYAI (Premium, standard), WHISPER (Standard) og ELEVENLABS (Ultra). For høyt volum der kostnad betyr mer enn finish, bruk Whisper — 1 syklus/min mot 4 for Premium:
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Tommelfingerregel: Premium for viktige møter og intervjuer; Standard (Whisper) for høyt volum og støyende lyd; Ultra når talerseparasjon må være feilfri (tilgjengelig på Profissional+).
Oppskrift 3 — automatiske undertekster
Be om formats: ["srt", "vtt"] og motta ferdige undertekster for YouTube eller nettspillere direkte i webhooken. Detaljer for hvert format finner du i Eksporter til andre verktøy.
Grenser som påvirker automatiseringer
| Element | Regel |
|---|---|
| Rate limit | 60 forespørsler/min per nøkkel |
audio_url | bare https, offentlig, opptil 500 MB (nedlasting) eller 5 GB via passthrough med Premium-engine |
| Formater | følger planens begrensninger; de som ikke er tillatt, returneres i exports_skipped |
| Nedlastingslenker | utløper etter 7 dager (transkripsjonen forblir i arkivet) |
| Sykluser | samme kostnader som på nettstedet, belastet den samme saldoen |
Overvåk syklussaldoen din: det finnes i dag ingen utgiftstak per nøkkel. En automatisering med ukontrollert løkke bruker ekte saldo. idempotency_key er din første forsvarslinje.
FAQ
Hvordan får jeg den endelige teksten — i webhooken eller må jeg laste ned?
Webhooken bringer utfallet og lenkene til de eksporterte filene i de forespurte formatene. Last ned filene innen 7 dager; etter det er innholdet fortsatt tilgjengelig i nettstedets arkiv.
Kan jeg angi lydens språk?
Ja, via feltet language. Uten det gjelder standarden for kontoen; automatisk deteksjon støttes også av enginene.
Hva om to systemer sender den samme lyden?
Bruk samme idempotency_key i begge — bare den første behandles og faktureres.
Fungerer automatiseringen for organisasjonsmedlemmer?
Ja — og forbruket følger selskapets planregler. For revisjon av samtaler i stor skala, se den dedikerte API-en.
Relaterte artikler
- Transkripsjons-API
- Webhooks og varsler
- Enterprise API for revisjon
- Hva er sykluser og hva koster hvert minutt
Ikke løst? Åpne en billett — teamet vårt svarer raskt.