Het SpeakNotes API, MCP-server en OAuth-platform
Zet audio, video en YouTube-links om in transcripties en gestructureerde samenvattingen vanuit je eigen code, of laat een AI-agent dit doen via MCP. Elk account kan gratis een sleutel aanmaken en in de sandbox beginnen.
- Maak zelf een sleutel aan in het dashboard. Geen verkoopgesprek, geen wachtlijst.
- Sandbox-sleutels geven een vaste output, verbruiken geen credits en raken nooit je echte notities aan.
- Een gehoste MCP-server zodat Claude, ChatGPT en Cursor SpeakNotes native kunnen gebruiken.
Drie verzoeken tot je eerste samenvatting
Begin met een sandbox-sleutel om de structuren te leren, en wissel naar een live-sleutel wanneer de antwoorden er goed uitzien.
- 1
Maak een sleutel aan
Open Instellingen, API-sleutels en maak er een aan. Kies sandbox om dingen uit te proberen, of live om echte audio te verwerken.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
Roep de API aan
Verzend de sleutel als een bearer-token. Samenvattingen, transcripties en YouTube-taken antwoorden inline.
curl -X POST https://api.speaknotes.io/v1/summaries \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "...your transcript...", "styleId": "meeting-notes"}' - 3
Upload langere media
Uploads draaien op de achtergrond: maak de upload aan, PUT het bestand, voltooi het en pols vervolgens de notitie totdat deze klaar is.
# 1. create the upload curl -X POST https://api.speaknotes.io/v1/uploads \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}' # 2. PUT the file to uploadUrl, then complete it curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" # 3. poll until status is Done curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY"
Wat het platform je biedt
Een REST API die leest en schrijft
Lijst, maak, update en verwijder notities en mappen. Transcribeer audio, vat tekst samen en vat YouTube-links samen. Elke operatie staat in de OpenAPI 3.1-specificatie.
Een gehoste MCP-server
Streamable HTTP op api.speaknotes.io/mcp, met dertien tools die dezelfde lees- en schrijfbewerkingen dekken. Agents maken verbinding via OAuth of met een sleutel.
OAuth 2.1 met PKCE
Bouw een app die namens andere SpeakNotes-gebruikers handelt. Dynamische clientregistratie betekent dat een MCP-client zichzelf kan registreren en verbinding kan maken zonder dat iemand een sleutel hoeft te plakken.
Een echte sandbox
Sleutels die beginnen met sn_test_ voeren elke route, validatieregel en antwoordstructuur uit tegen vaste output. Geen credits, geen modelaanroepen en schrijfacties landen in een aparte sandbox-bibliotheek.
Credits die je kunt inzien
Eén credit is één gestarte minuut aan media. Elk antwoord dat iets kost, geeft aan wat er in rekening is gebracht en wat er over is, zodat een agent dit kan controleren voordat hij begint.
Scoped credentials
Geef een sleutel of een app alleen wat nodig is. Een alleen-lezen sleutel kan notities weergeven maar nooit een notitie verwijderen.
Prijzen
Elk account krijgt een maandelijkse toelage aan credits die wordt gereset. Pro-accounts krijgen een veel grotere toelage. Daarbuiten zijn credits prepaid, dus een uit de hand gelopen retry-loop kan nooit een rekening doen oplopen.
Referentie
- QuickstartVan nul naar een werkende samenvatting, in curl.
- Authenticatie en scopesAPI-sleutels, sandbox-sleutels, scopes en rate limits.
- OAuth 2.1Autorisatiecode met PKCE, dynamische clientregistratie, verversing en intrekking.
- FoutcodesElke code die de API kan retourneren en wat je bij elk ervan moet doen.
- Credits en prijzenWat elke operatie kost en hoe je tegoed opwaardeert.
- OpenAPI 3.1 specificatieHet machineleesbare contract voor elke operatie.
- MCP-manifestServernaam, transport en toollijst op /.well-known/mcp.json.
- Agent skill-bestandEen drop-in SKILL.md voor agent-runtimes.
Vragen die ontwikkelaars stellen
- Is de SpeakNotes API gratis te gebruiken?
- Elk account krijgt maandelijks 60 credits gratis, en sandbox-sleutels zijn onbeperkt en voor altijd gratis. Pro-accounts krijgen 2.000 credits per maand. Buiten de maandelijkse toelage koop je prepaid credit-pakketten.
- Hoe krijg ik een SpeakNotes API-sleutel?
- Meld je aan en open Instellingen, API-sleutels. Je maakt de sleutel zelf aan en deze werkt direct. Er is geen aanvraagprocedure en geen contactformulier.
- Heeft SpeakNotes een sandbox-omgeving?
- Ja. Elke sleutel die je aanmaakt met de sandbox-optie begint met sn_test_. Het doorloopt elke route en geeft vaste, realistische output terug zonder een model aan te roepen, credits te verbruiken of naar je echte notities te schrijven.
- Hoe verbind ik SpeakNotes met Claude of een andere MCP-client?
- Wijs de client naar https://api.speaknotes.io/mcp via Streamable HTTP. Clients die OAuth ondersteunen registreren zichzelf en vragen je om toestemming; clients die dit niet doen, kunnen een SpeakNotes API-sleutel als bearer-token meesturen.
- Ondersteunt de SpeakNotes API OAuth?
- Ja. SpeakNotes draait een OAuth 2.1-autorisatieserver met PKCE, verversing van tokens, dynamische clientregistratie en intrekking. Metadata wordt gepubliceerd op https://speaknotes.io/.well-known/oauth-authorization-server.
- Wat zijn de rate limits van de SpeakNotes API?
- 120 leesverzoeken, 30 schrijfverzoeken en 10 verwerkingsverzoeken per minuut, geteld per credential. Elk antwoord bevat het resterende budget in de rate limit-headers, en een 429 vertelt je precies hoe lang je moet wachten.