4 min lezen Uploading Files

Audio verzenden via URL en API

Hoe importeer je audio via een directe URL in de interface en hoe verstuur je transcripties programmatisch via de API: abonnementen die in aanmerking komen, sleutels, authenticatie, limieten en webhooks.

Naast het uploaden van een bestand zijn er twee manieren "zonder bestand bij de hand": plak een media-URL in de interface (voor elke gebruiker) en verstuur via de API (voor Profissional-abonnementen en hoger) — ideaal om transcriptie te integreren met systemen, PABX en automatiseringen.

1. Importeren via URL in de interface

Op het scherm Nieuwe transcriptie accepteert dezelfde optie die YouTube accepteert ook directe URL's van audio-/videobestanden (https). De server downloadt de media en volgt het normale proces: taalkeuze (of automatische detectie), engine van het abonnement en kosten in cycli op basis van de duur. De duur- en grootte-limieten van jouw abonnement gelden hetzelfde.

2. Transcriptie-API

Wie mag het gebruiken

De API is beschikbaar vanaf het Profissional-abonnement (R$ 39,90/maand) — inclusief Premium, zakelijke en gelijkwaardige legacy-abonnementen. Bij andere abonnementen retourneert het aanmaken van een sleutel een melding dat het abonnement niet in aanmerking komt.

API-sleutels

Token-formaat: vpt_live_...;
Het geheim wordt één keer getoond bij het aanmaken — bewaar het in een kluis. Wij bewaren het geheim niet, alleen een vingerafdruk ervan;
Tot 20 actieve sleutels per account; je kunt op elk moment een sleutel intrekken;
Het beheer van persoonlijke sleutels in de interface wordt momenteel uitgerold — als je de optie niet in je account vindt, open dan een ticket en wij activeren het voor je.

Hoe een aanroep werkt

Authenticatie via header Authorization: Bearer vpt_live_.... In de body geef je de URL van de audio (audio_url, alleen https), de URL van je webhook om het resultaat te ontvangen, en optioneel engine, taal, exportformaten en een idempotentiesleutel.

Rate limit: 60 verzoeken per minuut per sleutel;
Grootte: audio via URL tot 500 MB voor download op de server; met de Premium-engine kunnen URL's tot 5 GB rechtstreeks door de engine worden gelezen, zonder tussentijdse download;
Kosten: dezelfde cycli als op de website, op basis van duur en engine.

Het resultaat ontvangen (webhooks)

Het resultaat komt binnen via een webhook die is ondertekend met HMAC-SHA256 (headers X-VPT-Signature en X-VPT-Event) — valideer de handtekening voordat je de payload vertrouwt. Als je endpoint offline is, sturen we opnieuw met oplopende wachttijden: tot 6 pogingen over ~24 uur.

We accepteren alleen https-URL's en blokkeren interne/privé-adressen om veiligheidsredenen. Als je audio achter authenticatie zit, genereer dan een tijdelijke ondertekende URL in je storage voordat je de API aanroept.

Geen openbare URL voor het bestand (bijv. PABX-opnames)? De zakelijke audit-API biedt een upload-endpoint dat een tijdelijke upload-URL retourneert (1 uur geldig) — neem contact op met sales als het om auditie van gesprekken in bulk gaat.

Veelgestelde vragen

Ik ben het geheim van de sleutel kwijt. Hoe krijg ik het terug?

Het is niet te herstellen — trek de sleutel in en maak een nieuwe aan. Het geheim bestaat alleen op het moment van aanmaken.

Heeft de API documentatie?

De volledige integratiereferentie wordt verstrekt bij het activeren van de toegang. Open een ticket met jouw gebruikssituatie.

Kan ik engine en taal kiezen bij de aanroep?

Ja, beide zijn optionele parameters — zonder deze worden de standaardengine van het abonnement en taaldetectie gebruikt.

Brengt de API andere kosten in rekening dan de website?

Nee. Dezelfde cycli, dezelfde regels (inclusief de korting alleen na succes).

Hoe trek ik een gecompromitteerde sleutel in?

Trek deze onmiddellijk in via het sleutelbeheer (of via ondersteuning). Het intrekken schakelt de toegang direct uit.