Transcripties automatiseren met de API: Praktische voorbeelden
Automatiseringsrecepten met de VoxScriber API: opnamen via URL verzenden, engine en formaten kiezen, idempotency_key en metadata gebruiken en alles via webhook ontvangen.
Met de API verander je elke bron van opnamen — telefonie, vergaderrecorder, intern systeem — in doorzoekbare tekst, zonder handmatige tussenkomst. Dit artikel bevat de aanbevolen werkwijze en kant-en-klare recepten. Bekijk eerst de vereisten in Transcriptie-API (Profissional+-plan en vpt_live_-sleutel).
De aanbevolen werkwijze
- Verstuur de audio via URL met een
webhook_url. - Ontvang de callback wanneer deze klaar is (succes of fout).
- Download de geëxporteerde bestanden via de links in het resultaat — ze blijven 7 dagen geldig.
Geen polling: met een limiet van 60 verzoeken per minuut per sleutel verspil je je quotum door status in een lus op te vragen. De webhook levert de uitkomst vanzelf, met tot 6 herleveringen als je server niet bereikbaar is.
Recept 1 — elke nieuwe opname transcriberen
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"
}'
metadatakomt terug in de webhook — gebruik het om het resultaat te koppelen aan het record in je systeem.idempotency_keyzorgt ervoor dat onbedoelde herverzendingen (retry aan jouw kant, een deploy midden in de job) niet hetzelfde audiobestand twee keer verwerken of in rekening brengen.
Recept 2 — de engine kiezen op basis van kosten
Het veld engine accepteert ASSEMBLYAI (Premium, standaard), WHISPER (Standaard) en ELEVENLABS (Ultra). Voor hoge volumes waarbij de kosten belangrijker zijn dan de afwerking, gebruik je Whisper — 1 cyclus/min tegenover 4 voor Premium:
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Vuistregel: Premium voor belangrijke vergaderingen en interviews; Standaard (Whisper) voor hoge volumes en audio met ruis; Ultra wanneer sprekerscheiding vlekkeloos moet zijn (beschikbaar in Profissional+).
Recept 3 — automatische ondertiteling
Vraag formats: ["srt", "vtt"] en ontvang de ondertitels, klaar voor YouTube of webplayers, direct in de webhook. Details over elk formaat vind je in Exporteren naar andere tools.
Limieten die automatiseringen beïnvloeden
| Item | Regel |
|---|---|
| Rate limit | 60 req/min per sleutel |
audio_url | alleen https, openbaar, tot 500 MB (download) of 5 GB via passthrough met de Premium-engine |
| Formaten | volgen de beperkingen van je plan; niet toegestane formaten komen terug in exports_skipped |
| Downloadlinks | verlopen na 7 dagen (de transcriptie blijft in het archief) |
| Cycli | zelfde kosten als op de site, afgeschreven van hetzelfde saldo |
Houd je cyclus-saldo in de gaten: er is momenteel geen uitgavenplafond per sleutel. Een automatisering met een ongecontroleerde lus verbruikt echt saldo. De idempotency_key is je eerste verdedigingslinie.
FAQ
Hoe ontvang ik de definitieve tekst — via de webhook of moet ik downloaden?
De webhook levert de uitkomst en de links naar de geëxporteerde bestanden in de gevraagde formaten. Download de bestanden binnen 7 dagen; daarna blijft de inhoud beschikbaar in het archief van de site.
Kan ik de taal van de audio instellen?
Ja, via het veld language. Zonder dit veld geldt de standaard van het account; automatische detectie wordt ook ondersteund door de engines.
Wat als twee systemen dezelfde audio versturen?
Gebruik dezelfde idempotency_key in beide systemen — alleen de eerste verwerkt en brengt kosten in rekening.
Werkt de automatisering voor organisatieleden?
Ja — en het verbruik volgt de regels van het bedrijfsplan. Voor grootschalige gespreksaudits, zie de speciale API.
Gerelateerde artikelen
Niet gevonden wat je zocht? Open een ticket — ons team reageert snel.