Entwicklerplattform

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

60
Credits pro Monat im kostenlosen Plan
2,000
Credits pro Monat mit Pro
Credit-Preise ansehen

Referenz

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.