REST API om audio te transcriberen vanuit je eigen software
Upload audio met een POST-verzoek, wacht op een seintje en haal het transcript op als JSON. Zo bouw je Nederlandse spraak naar tekst in je eigen workflow.
{
"file": "interview.m4a",
"language": "nl",
"speakers": true,
"webhook": "https://je.app/klaar"
}
→ 202 Accepted
{
"id": "tr_8f3k29",
"status": "processing"
}Hoe een aanroep eruitziet
Je stuurt een POST-verzoek met het audiobestand en je API-sleutel. Genoteerd antwoordt meteen met een id voor de opdracht en begint met de verwerking.
Daarna heb je twee keuzes. Je vraagt zo nu en dan de status van de opdracht op, tot die klaar is. Of je geeft een webhook-adres op: dan stuurt Genoteerd een bericht zodra het transcript klaar is.
Is de opdracht klaar, dan haal je het transcript op met een GET-verzoek op dat id. Je krijgt het terug als JSON en verwerkt het in je eigen systeem.
Aan de slag
01
Vraag een API-sleutel aan
De sleutel hoort bij je account en identificeert je aanvragen.
02
Test met een kort bestand
Upload een opname van een paar seconden en bekijk de JSON die je terugkrijgt.
03
Kies poll of webhook
Poll is het eenvoudigst om te beginnen, een webhook past beter bij productie.
04
Bouw de koppeling
Sla het transcript op waar je het nodig hebt en handel mislukte opdrachten netjes af.
Waarvoor je de API gebruikt
Spraakinvoer in je eigen app
Laat gebruikers een opname uploaden en toon de tekst in je product.
Een archief omzetten
Zet een map met oude opnames in één keer om in doorzoekbare tekst.
Interne vergadertools
Koppel opnames van je eigen vergadersysteem aan een transcript.
Automatische workflows
Start een transcript zodra er ergens een bestand binnenkomt.
Zoekbare mediabibliotheek
Maak audio en video doorzoekbaar met de tekst erbij.
Voor je koppelt
- Het webhook-adres is bereikbaar vanaf het internet en veilig.
- Je verwerkt mislukte opdrachten, bijvoorbeeld door opnieuw te proberen.
- Je houdt rekening met de limieten: 12 uur per bestand, 1 of 2 GB en 2 of 3 opdrachten tegelijk.
- Je bewaart de API-sleutel niet in code die iemand kan inzien.
- Je kiest een bewaartermijn voor de opnames die past bij de inhoud.
Waar je data blijft
Opnames die je via de API aanbiedt, dienen standaard alleen voor jouw transcript. De AI-dienst bewaart ze alleen tijdens de verwerking en jij bepaalt hoe lang een opname bij ons bewaard blijft.
Vragen over api
Moet ik pollen of kan ik een webhook gebruiken?
Allebei kan. Bij pollen vraag je zelf de status op tot de opdracht klaar is. Met een webhook stuurt Genoteerd je een bericht op het adres dat je opgeeft.
In welk formaat krijg ik het transcript?
Als JSON. Wil je een leesbaar bestand zoals PDF of een ondertitelbestand als SRT, dan exporteer je dat in de app.
Welke bestanden accepteert de API?
Dezelfde audio- en videoformaten als de app, zoals mp3, m4a, wav, flac, mp4 en mov. Een bestand mag tot 12 uur duren en maximaal 1 GB (Basic) of 2 GB (Creator, Pro, Scale) zijn.
Wat gebeurt er met audio via de API?
De AI-dienst bewaart je audio alleen tijdens de verwerking. Standaard dient je audio alleen voor jouw transcript.
Hoe kom ik aan een API-sleutel of meer informatie?
Neem contact met ons op. Dan kijken we samen wat je wilt bouwen en welk abonnement daarbij past.
Verder lezen
Exporteren
Download transcripten als TXT, SRT, VTT, RTF, PDF, JSON, CSV of audio.
Hoe het werkt
Vijf stappen van audio naar tekst, inclusief wat er met je opname gebeurt.
Beveiliging
Waar je data staat, wat Genoteerd ermee doet en wat je zelf regelt.
Prijzen
Abonnementen vanaf €10,89 of losse credits zonder abonnement.
Contact
Stel een vraag of vraag een offerte aan.
Wil je Genoteerd in je eigen product gebruiken
Neem contact op en vertel wat je wilt bouwen. Dan zoeken we uit hoe de API daarbij past.