Die SpeakNotes API, MCP-Server und OAuth-Plattform
Verwandeln Sie Audio-, Video- und YouTube-Links in Transkripte und strukturierte Zusammenfassungen aus Ihrem eigenen Code oder lassen Sie einen KI-Agenten dies über MCP erledigen. Jeder Account kann einen Schlüssel erstellen und kostenlos in der Sandbox starten.
- Erstellen Sie selbst einen Schlüssel im Dashboard. Keine Verkaufsgespräche, keine Warteliste.
- Sandbox-Schlüssel liefern feste Ausgaben, verbrauchen keine Kredite und berühren niemals Ihre echten Notizen.
- Ein gehosteter MCP-Server, damit Claude, ChatGPT und Cursor SpeakNotes nativ nutzen können.
Drei Anfragen bis zur ersten Zusammenfassung
Starten Sie mit einem Sandbox-Schlüssel, um die Strukturen kennenzulernen, und wechseln Sie dann zu einem Live-Schlüssel, wenn die Antworten passen.
- 1
Schlüssel erstellen
Öffnen Sie die Einstellungen, API-Schlüssel und erstellen Sie einen. Wählen Sie Sandbox zum Ausprobieren oder Live, um echtes Audio zu verarbeiten.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
API aufrufen
Senden Sie den Schlüssel als Bearer-Token. Zusammenfassungen, Transkriptionen und YouTube-Aufträge antworten 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
Längere Medien hochladen
Uploads laufen im Hintergrund: Erstellen Sie den Upload, führen Sie ein PUT der Datei aus, schließen Sie ihn ab und fragen Sie die Notiz ab, bis sie fertig ist.
# 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"
Was die Plattform Ihnen bietet
Eine REST-API zum Lesen und Schreiben
Notizen und Ordner auflisten, erstellen, aktualisieren und löschen. Audio transkribieren, Text zusammenfassen und YouTube-Links zusammenfassen. Jeder Vorgang entspricht der OpenAPI 3.1 Spezifikation.
Ein gehosteter MCP-Server
Streambares HTTP unter api.speaknotes.io/mcp, mit dreizehn Tools, die dieselben Lese- und Schreibvorgänge abdecken. Agenten verbinden sich über OAuth oder mit einem Schlüssel.
OAuth 2.1 mit PKCE
Bauen Sie eine App, die im Namen anderer SpeakNotes-Nutzer agiert. Dynamische Client-Registrierung bedeutet, dass sich ein MCP-Client selbst registrieren und verbinden kann, ohne dass jemand einen Schlüssel kopieren muss.
Eine echte Sandbox
Schlüssel, die mit sn_test_ beginnen, führen jede Route, Validierungsregel und Antwortstruktur gegen feste Ausgaben aus. Keine Kredite, keine Modellaufrufe und Schreibvorgänge landen in einer separaten Sandbox-Bibliothek.
Kredite, die Sie im Blick haben
Ein Kredit entspricht einer begonnenen Minute Medien. Jede Antwort, die etwas kostet, gibt an, was berechnet wurde und was übrig ist, sodass ein Agent dies prüfen kann, bevor er startet.
Bereichsbezogene Anmeldeinformationen
Geben Sie einem Schlüssel oder einer App nur das, was sie benötigt. Ein schreibgeschützter Schlüssel kann Notizen auflisten, aber niemals eine löschen.
Preise
Jedes Konto erhält ein monatliches Guthaben, das zurückgesetzt wird. Pro-Konten erhalten ein deutlich höheres Guthaben. Darüber hinaus ist das Guthaben im Voraus bezahlt, sodass eine außer Kontrolle geratene Wiederholungsschleife niemals zu einer hohen Rechnung führen kann.
Referenz
- SchnellstartVon Null zu einer funktionierenden Zusammenfassung, mit curl.
- Authentifizierung und BereicheAPI-Schlüssel, Sandbox-Schlüssel, Bereiche und Ratenbegrenzungen.
- OAuth 2.1Autorisierungscode mit PKCE, dynamische Client-Registrierung, Aktualisierung und Widerruf.
- FehlercodesJeder Code, den die API zurückgeben kann, und was bei jedem einzelnen zu tun ist.
- Credits und PreiseWas jeder Vorgang kostet und wie man Guthaben auflädt.
- OpenAPI 3.1 SpezifikationDer maschinenlesbare Vertrag für jeden Vorgang.
- MCP-ManifestServername, Transport und Tool-Liste unter /.well-known/mcp.json.
- Agent-Skill-DateiEine fertige SKILL.md für Agent-Runtimes.
Häufige Fragen von Entwicklern
- Ist die SpeakNotes API kostenlos?
- Jedes Konto erhält monatlich 60 Credits kostenlos, und Sandbox-Schlüssel sind unbegrenzt und für immer kostenlos. Pro-Konten erhalten 2.000 Credits pro Monat. Über das monatliche Guthaben hinaus können Sie Prepaid-Credit-Pakete erwerben.
- Wie erhalte ich einen SpeakNotes API-Schlüssel?
- Melden Sie sich an und öffnen Sie die Einstellungen unter API-Schlüssel. Sie erstellen den Schlüssel selbst und er funktioniert sofort. Es gibt keinen Bewerbungsprozess und kein Kontaktformular.
- Hat SpeakNotes eine Sandbox-Umgebung?
- Ja. Jeder Schlüssel, den Sie mit der Sandbox-Option erstellen, beginnt mit sn_test_. Er führt jede Route aus und gibt feste, realistische Ausgaben zurück, ohne ein Modell aufzurufen, Credits zu verbrauchen oder in Ihre echten Notizen zu schreiben.
- Wie verbinde ich SpeakNotes mit Claude oder einem anderen MCP-Client?
- Verweisen Sie den Client über Streamable HTTP auf https://api.speaknotes.io/mcp. Clients, die OAuth unterstützen, registrieren sich selbst und fordern Sie zur Autorisierung auf; Clients, die dies nicht tun, können einen SpeakNotes API-Schlüssel als Bearer-Token senden.
- Unterstützt die SpeakNotes API OAuth?
- Ja. SpeakNotes betreibt einen OAuth 2.1-Autorisierungsserver mit PKCE, Refresh-Token-Rotation, dynamischer Client-Registrierung und Widerruf. Metadaten werden unter https://speaknotes.io/.well-known/oauth-authorization-server veröffentlicht.
- Was sind die Ratenbegrenzungen der SpeakNotes API?
- 120 Leseanfragen, 30 Schreibanfragen und 10 Verarbeitungsanfragen pro Minute, gezählt pro Anmeldeinformation. Jede Antwort enthält das verbleibende Budget in ihren Ratenbegrenzungs-Headern, und ein 429-Fehler sagt Ihnen genau, wie lange Sie warten müssen.