Automatiser transskription med API'en: Praktiske eksempler
Automatiseringsopskrifter med VoxScriber API: Send optagelser via URL, vælg engine og formater, brug idempotency_key og metadata, og modtag alt via webhook.
Med API'en kan du forvandle enhver kilde til optagelser — telefoni, mødeoptager, internt system — til søgbar tekst uden manuel indgriben. Denne artikel viser den anbefalede arbejdsgang og færdige opskrifter. Se først forudsætningerne i API til transskription (Profissional+ og nøgle vpt_live_).
Den anbefalede arbejdsgang
- Send lyden via URL med en
webhook_url. - Modtag callback, når den er færdig (succes eller fejl).
- Download de eksporterede filer via links i resultatet — de er gyldige i 7 dage.
Intet polling: med en grænse på 60 anmodninger/minut pr. nøgle spilder du kvoten ved at tjekke status i en løkke. Webhooken leverer resultatet af sig selv, med op til 6 genleveringer, hvis din server er nede.
Opskrift 1 — transskriber alle nye optagelser
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"
}'
metadatareturneres i webhooken — brug den til at korrelere resultatet med posten i dit system.idempotency_keysikrer, at utilsigtede gensendelser (retry fra din side, deploy midt i jobbet) ikke behandler eller opkræver for den samme lyd to gange.
Opskrift 2 — vælg engine efter pris
Feltet engine accepterer ASSEMBLYAI (Premium, standard), WHISPER (Standard) og ELEVENLABS (Ultra). Til store mængder, hvor prisen betyder mere end finishen, brug Whisper — 1 cyklus/min mod 4 for Premium:
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Tommelfingerregel: Premium til vigtige møder og interviews; Standard (Whisper) til store mængder og støjende lyd; Ultra, når taleradskillelse skal være upåklagelig (tilgængelig i Profissional+).
Opskrift 3 — automatiske undertekster
Bed om formats: ["srt", "vtt"] og modtag underteksterne klar til YouTube eller webafspillere direkte i webhooken. Detaljer om hvert format findes i Eksporter til andre værktøjer.
Grænser, der påvirker automatiseringer
| Item | Regel |
|---|---|
| Rate limit | 60 anmodninger/min pr. nøgle |
audio_url | kun https, offentlig, op til 500 MB (download) eller 5 GB via passthrough med Premium-enginen |
| Formater | følger din plans gate; de ikke-tilladte returneres i exports_skipped |
| Downloadlinks | udløber efter 7 dage (transskriptionen forbliver i arkivet) |
| Cyklusser | samme priser som på hjemmesiden, trukket fra samme saldo |
Overvåg din cyklussaldo: der er i dag ikke noget forbrugsloft pr. nøgle. En automatisering med en ukontrolleret løkke bruger reelt saldo. idempotency_key er din første forsvarslinje.
FAQ
Hvordan modtager jeg den endelige tekst — via webhook eller skal jeg downloade?
Webhooken leverer resultatet og links til de eksporterede filer i de ønskede formater. Download filerne inden for 7 dage; derefter forbliver indholdet tilgængeligt i arkivet på hjemmesiden.
Kan jeg angive lydens sprog?
Ja, via feltet language. Uden det bruges kontoens standard; automatisk sprogdetektering understøttes også af engine'ene.
Hvad hvis to systemer sender den samme lyd?
Brug den samme idempotency_key i begge — kun den første behandles og opkræves.
Fungerer automatiseringen for organisationsmedlemmer?
Ja — og forbruget følger virksomhedens planregler. Til audit af opkald i stor skala, se den dedikerede API.
Relaterede artikler
Ikke løst? Åbn en billet — vores team svarer hurtigt.