Piattaforma per sviluppatori

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. 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. 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. 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.

60
crediti al mese nel piano gratuito
2,000
crediti al mese con Pro
Vedi i prezzi dei crediti

Riferimenti

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.