SpeakNotesSpeakNotes
Aan de slag

SpeakNotes API-documentatie

De SpeakNotes API verandert audio, video, YouTube-links en documenten in transcripties en gestructureerde samenvattingen. Het is een REST API met een OpenAPI 3.1-specificatie, een agent-skillbestand en een MCP-server voor AI-clients.

Basis-URL

Elk SpeakNotes API-verzoek gaat naar één host via HTTPS.

https://api.speaknotes.io

Authenticatie

Elk eindpunt vereist authenticatie. Stuur een SpeakNotes API-sleutel als bearer-token, of een Firebase ID-token als je belt vanuit een ingelogde sessie. Niet-geauthenticeerde verzoeken worden geweigerd.

Authorization: Bearer YOUR_API_KEY

Maak en beheer sleutels in Instellingen, API-sleutels. Elke ingelogde gebruiker kan de pagina bekijken; voor het aanmaken van een sleutel is een actief Pro-abonnement vereist.

Eindpunten

Uploads en YouTube-taken worden asynchroon uitgevoerd: maak de notitie aan en pols vervolgens de status totdat de verwerking is voltooid.

  • POST/youtube-checkValideer een YouTube-URL en controleer duurbeperkingen
  • POST/youtube-summaryMaak een notitie van YouTube en start de samenvatting
  • POST/upload-urlMaak een notitie aan en ontvang een ondertekende media-upload-URL
  • POST/upload-completeBevestig de media-upload en start de verwerking
  • POST/pdf-upload-urlMaak een notitie aan en ontvang een ondertekende document-upload-URL
  • POST/pdf-upload-completeBevestig de document-upload en start de verwerking
  • GET/api/v1/notesLijst je notities op
  • GET/api/v1/notes/{id}Haal een enkele notitie op
  • GET/api/v1/notes/{id}/statusVraag de verwerkingsstatus van een notitie op
  • GET/api/v1/foldersLijst uw mappen op
  • GET/api/v1/folders/{id}Haal een enkele map op

MCP-server

SpeakNotes draait een Model Context Protocol-server via Streamable HTTP, zodat MCP-clients transcriptie en samenvatting als tools kunnen aanroepen. Het gebruikt dezelfde bearer API-sleutel als de REST API.

https://api.speaknotes.io/mcp

Ontwikkelaarsbronnen