Naar de inhoud

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.

POST /v1/transcripts
{
  "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

  1. 01

    Vraag een API-sleutel aan

    De sleutel hoort bij je account en identificeert je aanvragen.

  2. 02

    Test met een kort bestand

    Upload een opname van een paar seconden en bekijk de JSON die je terugkrijgt.

  3. 03

    Kies poll of webhook

    Poll is het eenvoudigst om te beginnen, een webhook past beter bij productie.

  4. 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.

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.