SpeakNotesSpeakNotes
Inizia

Documentazione API di SpeakNotes

L'API di SpeakNotes trasforma audio, video, link YouTube e documenti in trascrizioni e riassunti strutturati. È un'API REST con una specifica OpenAPI 3.1, un file di skill per agenti e un server MCP per client AI.

URL di base

Ogni richiesta API di SpeakNotes viene inviata a un singolo host tramite HTTPS.

https://api.speaknotes.io

Autenticazione

Ogni endpoint richiede l'autenticazione. Invia una chiave API di SpeakNotes come bearer token, o un token ID Firebase se stai chiamando da una sessione con accesso effettuato. Le richieste non autenticate vengono rifiutate.

Authorization: Bearer YOUR_API_KEY

Crea e revoca le chiavi in Impostazioni, chiavi API. Qualsiasi utente con accesso può visualizzare la pagina; la creazione di una chiave richiede un piano Pro attivo.

Endpoint

I caricamenti e i lavori YouTube vengono eseguiti in modo asincrono: crea la nota, quindi interroga il suo stato fino al termine dell'elaborazione.

  • 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

Server MCP

SpeakNotes esegue un server Model Context Protocol tramite HTTP streamable, in modo che i client MCP possano richiamare la trascrizione e la riassunzione come strumenti. Utilizza la stessa chiave API bearer dell'API REST.

https://api.speaknotes.io/mcp

Risorse per sviluppatori