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.

  • GET/v1Describe the API
  • GET/v1/healthCheck the API is up
  • GET/v1/notesList notes
  • POST/v1/notesCreate a note from text
  • GET/v1/notes/{id}Get a note
  • PATCH/v1/notes/{id}Update a note
  • DELETE/v1/notes/{id}Delete a note
  • GET/v1/notes/{id}/statusGet processing status
  • GET/v1/notes/{id}/transcriptGet a transcript
  • POST/v1/notes/{id}/questionsAsk a question about a note
  • GET/v1/foldersList folders
  • POST/v1/foldersCreate a folder
  • GET/v1/folders/{id}Get a folder
  • PATCH/v1/folders/{id}Rename a folder
  • DELETE/v1/folders/{id}Delete a folder
  • POST/v1/uploadsStart a media upload
  • POST/v1/uploads/{id}/completeFinish an upload and start processing
  • POST/v1/transcriptionsTranscribe audio from a URL
  • POST/v1/summariesSummarize text
  • POST/v1/youtube-summariesSummarize a YouTube video
  • GET/v1/usageGet credit balance and usage

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