Transcriptie-API: Overzicht, Authenticatie en Limieten

Q: Kan ik het bestand rechtstreeks versturen in plaats van een URL?

Het primaire kanaal is via audio_url . Als je audio geen openbare URL heeft, neem dan contact op met de ondersteuning om de beste workflow voor jouw situatie te beoordelen.

Q: Bestaat er OpenAPI-documentatie?

De openbare spec in /.well-known/openapi.json dekt momenteel alleen de publieke endpoints (statistieken en gedeelde transcripties). Gebruik voor de rest dit helpcentrum en de ondersteuning.

Zo gebruik je de REST-API van VoxScriber: wie toegang heeft, hoe vpt_live_-sleutels werken, Bearer-authenticatie, aanvraaglimieten en facturering in cycli.

De REST-API van VoxScriber stelt je in staat om audio via URL te versturen en de kant-en-klare transcriptie in je eigen systeem te ontvangen, zonder via de website te gaan. Deze gebruikt dezelfde engines en rekent dezelfde cycli als transcripties via het dashboard.

Wie kan het gebruiken

De API is beschikbaar vanaf het Profissional-plan (R$ 39,90/maand). Toegang hebben: Profissional, Premium, alle Empresariais-plannen (maandelijks en jaarlijks) en de gelijkwaardige legacy-plannen. Als je account niet in aanmerking komt, retourneren de sleutelroutes de fout 403 PLAN_NOT_ELIGIBLE.

API-sleutels

Maak de sleutel

Elk account kan maximaal 20 actieve sleutels hebben, elk met een identificatienaam.

Kopieer het geheim direct

De sleutel heeft de vorm vpt_live_... en wordt slechts één keer getoond, op het moment van aanmaken. Wij bewaren alleen een hash ervan — het is niet mogelijk om hem later te achterhalen.

Bewaar veilig

Bewaar de sleutel in een omgevingsvariabele of een secrets-kluis. Zet de sleutel nooit in code die in versiebeheer staat.

Sleutel kwijt? Er is geen manier om hem opnieuw te tonen. Trek de oude sleutel in en maak een nieuwe aan. Gecompromitteerde sleutels moeten onmiddellijk worden ingetrokken.

Het aanmaken van persoonlijke sleutels heeft nog geen eigen scherm in het dashboard. Als je plan in aanmerking komt en je wilt de API gaan gebruiken, open dan een ticket; het team activeert de toegang samen met jou.

Authenticatie

Elke aanvraag bevat de sleutel in de header Authorization:

Authorization: Bearer vpt_live_SUA_CHAVE

Een aanvraag zonder deze header retourneert 401 MISSING_API_KEY.

Een audio versturen voor transcriptie

Het transcriptie-endpoint bevindt zich op de gateway 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"]
  }'

Geaccepteerde velden in de body: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER of ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata en idempotency_key. Het resultaat wordt naar je webhook_url gestuurd — zie Webhooks en meldingen.

Gebruik idempotency_key met een eigen identificatie (bijv. het ID van de opname in jouw systeem). Als dezelfde aanvraag per ongeluk opnieuw wordt verzonden, wordt de audio niet twee keer verwerkt — en ook niet twee keer gefactureerd.

Limieten

Limiet	Waarde
Aanvragen per sleutel	60 per minuut
Audio gedownload via URL	tot 500 MB (time-out van 60 s)
Audio via passthrough (Premium-engine leest de URL rechtstreeks)	tot 5 GB
Actieve sleutels per account	20

Veiligheidsregels voor URL's: alleen https, geen omleidingen, en interne/private adressen worden geblokkeerd. De audio-URL moet openbaar toegankelijk zijn.

De beschikbare exportformaten volgen de planbeperkingen van je account, net als op de site — formaten buiten je plan worden geretourneerd in exports_skipped.

Facturering

De API rekent de zelfde cycli als een transcriptie via de website, afhankelijk van de gekozen engine (Padrão/Whisper: 1 cyclus/min; Premium: 4 cycli/min; Ultra: 10 cycli/min). Er is momenteel geen maandelijkse limiet op het aantal aanvragen en geen uitgavenplafond per sleutel — beheer je verbruik via je cyclus-saldo. Zie Cyclussysteem.

FAQ

Ik ben mijn API-sleutel kwijt. Hoe kan ik die terugkrijgen?

Terugkrijgen is niet mogelijk — alleen de hash wordt in de database bewaard. Trek de verloren sleutel in en maak een nieuwe aan.

Rekent de API meer dan de website?

Nee. De kosten in cycli zijn identiek en worden bepaald door de engine en de duur van de audio.

Kan ik het bestand rechtstreeks versturen in plaats van een URL?

Het primaire kanaal is via audio_url. Als je audio geen openbare URL heeft, neem dan contact op met de ondersteuning om de beste workflow voor jouw situatie te beoordelen.

Bestaat er OpenAPI-documentatie?

De openbare spec in /.well-known/openapi.json dekt momenteel alleen de publieke endpoints (statistieken en gedeelde transcripties). Gebruik voor de rest dit helpcentrum en de ondersteuning.