La piattaforma API, server MCP e OAuth di SpeakNotes
Trasforma audio, video e link di YouTube in trascrizioni e riassunti strutturati dal tuo codice, o lascia che un agente AI lo faccia tramite MCP. Ogni account può creare una chiave e iniziare gratuitamente nella sandbox.
- Crea una chiave autonomamente nella dashboard. Nessuna chiamata di vendita, nessuna lista d'attesa.
- Le chiavi sandbox restituiscono output fissi, non consumano crediti e non toccano mai le tue note reali.
- Un server MCP ospitato affinché Claude, ChatGPT e Cursor possano utilizzare SpeakNotes in modo nativo.
Tre richieste per il tuo primo riassunto
Inizia con una chiave sandbox per imparare le strutture, poi passa a una chiave live quando le risposte sembrano corrette.
- 1
Crea una chiave
Apri Impostazioni, chiavi API e creane una. Scegli sandbox per provare, o live per elaborare audio reale.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
Chiama l'API
Invia la chiave come bearer token. Riassunti, trascrizioni e lavori YouTube rispondono 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
Carica file multimediali più lunghi
I caricamenti vengono eseguiti in background: crea il caricamento, esegui PUT del file, completalo, quindi interroga la nota finché non è pronta.
# 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"
Cosa ti offre la piattaforma
Un'API REST che legge e scrive
Elenca, crea, aggiorna ed elimina note e cartelle. Trascrivi audio, riassumi testo e riassumi link YouTube. Ogni operazione è nelle specifiche OpenAPI 3.1.
Un server MCP ospitato
HTTP streamable su api.speaknotes.io/mcp, con tredici strumenti che coprono le stesse operazioni di lettura e scrittura. Gli agenti si connettono tramite OAuth o con una chiave.
OAuth 2.1 con PKCE
Crea un'app che agisce per altri utenti SpeakNotes. La registrazione dinamica del client significa che un client MCP può registrarsi e connettersi senza che nessuno debba incollare una chiave.
Una vera sandbox
Le chiavi che iniziano con sn_test_ eseguono ogni percorso, regola di validazione e forma di risposta contro un output fisso. Nessun credito, nessuna chiamata ai modelli e le scritture finiscono in una libreria sandbox separata.
Crediti che puoi monitorare
Un credito equivale a un minuto di file multimediale avviato. Ogni risposta a pagamento restituisce il costo addebitato e il saldo rimanente, così un agente può controllare prima di iniziare.
Credenziali con ambito limitato
Dai a una chiave o a un'app solo ciò di cui ha bisogno. Una chiave di sola lettura può elencare le note e non eliminarne mai una.
Prezzi
Ogni account riceve una dotazione mensile di crediti che si azzera. Gli account Pro ne ricevono una molto più ampia. Oltre a ciò, i crediti sono prepagati, quindi un ciclo di tentativi fuori controllo non potrà mai generare un addebito imprevisto.
Riferimenti
- Guida rapidaDa zero a un riassunto funzionante, in curl.
- Autenticazione e ambitiChiavi API, chiavi sandbox, ambiti e limiti di frequenza.
- OAuth 2.1Codice di autorizzazione con PKCE, registrazione dinamica del client, aggiornamento e revoca.
- Codici di erroreOgni codice che l'API può restituire e cosa fare per ciascuno di essi.
- Crediti e prezziQuanto costa ogni operazione e come ricaricare.
- Specifica OpenAPI 3.1Il contratto leggibile dalla macchina per ogni operazione.
- Manifesto MCPNome del server, trasporto ed elenco degli strumenti su /.well-known/mcp.json.
- File delle abilità dell'agenteUn file SKILL.md pronto all'uso per i runtime degli agenti.
Domande frequenti degli sviluppatori
- L'API di SpeakNotes è gratuita?
- Ogni account riceve 60 crediti al mese gratuitamente e le chiavi sandbox sono illimitate e gratuite per sempre. Gli account Pro ricevono 2.000 crediti al mese. Oltre alla dotazione mensile, è possibile acquistare pacchetti di crediti prepagati.
- Come ottengo una chiave API di SpeakNotes?
- Accedi e apri Impostazioni, Chiavi API. Puoi creare la chiave autonomamente e funziona immediatamente. Non è prevista alcuna procedura di candidatura né modulo di contatto.
- SpeakNotes dispone di un ambiente sandbox?
- Sì. Ogni chiave creata con l'opzione sandbox inizia con sn_test_. Esegue ogni percorso e restituisce un output fisso e realistico senza chiamare un modello, consumare crediti o scrivere nelle tue note reali.
- Come collego SpeakNotes a Claude o a un altro client MCP?
- Punta il client su https://api.speaknotes.io/mcp tramite HTTP streamable. I client che supportano OAuth si registrano autonomamente e ti richiedono l'autorizzazione; i client che non lo supportano possono inviare una chiave API di SpeakNotes come bearer token.
- L'API di SpeakNotes supporta OAuth?
- Sì. SpeakNotes esegue un server di autorizzazione OAuth 2.1 con PKCE, rotazione dei refresh token, registrazione dinamica dei client e revoca. I metadati sono pubblicati su https://speaknotes.io/.well-known/oauth-authorization-server.
- Quali sono i limiti di frequenza dell'API di SpeakNotes?
- 120 richieste di lettura, 30 richieste di scrittura e 10 richieste di elaborazione al minuto, conteggiate per credenziale. Ogni risposta riporta il budget rimanente nelle intestazioni dei limiti di frequenza e un errore 429 indica esattamente quanto tempo attendere.