SpeakNotesSpeakNotes
Zacznij teraz
Platforma deweloperska

SpeakNotes API, serwer MCP i platforma OAuth

Zamieniaj pliki audio, wideo i linki z YouTube na transkrypcje i ustrukturyzowane podsumowania z poziomu własnego kodu lub pozwól agentowi AI zrobić to przez MCP. Każde konto może utworzyć klucz i rozpocząć pracę w środowisku sandbox za darmo.

  • Utwórz klucz samodzielnie w panelu. Bez rozmów sprzedażowych i list oczekujących.
  • Klucze sandbox zwracają stałe dane wyjściowe, nie zużywają kredytów i nie ingerują w Twoje rzeczywiste notatki.
  • Hostowany serwer MCP, dzięki któremu Claude, ChatGPT i Cursor mogą natywnie korzystać ze SpeakNotes.
Utwórz klucz APIPrzeczytaj przewodnik szybkiego startu

Trzy zapytania do Twojego pierwszego podsumowania

Zacznij od klucza sandbox, aby poznać strukturę danych, a następnie przełącz się na klucz produkcyjny, gdy odpowiedzi będą wyglądać poprawnie.

  1. 1

    Utwórz klucz

    Otwórz Ustawienia, klucze API i utwórz jeden. Wybierz sandbox, aby przetestować funkcje, lub klucz produkcyjny, aby przetwarzać rzeczywiste pliki audio.

    # Any signed-in account can create one. Sandbox keys start sn_test_.
open https://speaknotes.io/settings/api-keys
  2. 2

    Wywołaj API

    Wyślij klucz jako token bearer. Podsumowania, transkrypcje i zadania YouTube są zwracane w czasie rzeczywistym.

    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

    Prześlij dłuższe pliki

    Przesyłanie odbywa się w tle: utwórz zadanie przesyłania, wyślij plik metodą PUT, zakończ proces, a następnie sprawdzaj status notatki, aż będzie gotowa.

    # 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"

Co oferuje platforma

API REST do odczytu i zapisu

Wyświetlaj, twórz, aktualizuj i usuwaj notatki oraz foldery. Transkrybuj audio, podsumowuj tekst i linki z YouTube. Każda operacja jest zgodna ze specyfikacją OpenAPI 3.1.

Hostowany serwer MCP

Strumieniowe HTTP pod adresem api.speaknotes.io/mcp, z trzynastoma narzędziami obejmującymi te same operacje odczytu i zapisu. Agenci łączą się przez OAuth lub za pomocą klucza.

OAuth 2.1 z PKCE

Stwórz aplikację działającą w imieniu innych użytkowników SpeakNotes. Dynamiczna rejestracja klientów oznacza, że klient MCP może zarejestrować się samodzielnie i połączyć bez konieczności ręcznego wklejania klucza.

Prawdziwe środowisko sandbox

Klucze zaczynające się od sn_test_ uruchamiają każdą trasę, regułę walidacji i strukturę odpowiedzi w oparciu o stałe dane wyjściowe. Brak zużycia kredytów, brak wywołań modeli, a zapisy trafiają do oddzielnej biblioteki sandbox.

Przejrzyste kredyty

Jeden kredyt to jedna rozpoczęta minuta mediów. Każda odpowiedź, która wiąże się z kosztem, zwraca informację o pobranej opłacie i pozostałym saldzie, dzięki czemu agent może sprawdzić stan konta przed rozpoczęciem pracy.

Poświadczenia o ograniczonym zakresie

Przyznaj kluczowi lub aplikacji tylko to, czego potrzebują. Klucz z uprawnieniami tylko do odczytu może wyświetlać notatki, ale nigdy ich nie usunie.

Cennik

Każde konto otrzymuje miesięczny przydział kredytów, który się resetuje. Konta Pro otrzymują znacznie większy przydział. Poza tym kredyty są przedpłacone, więc niekontrolowana pętla ponownych prób nigdy nie wygeneruje nieoczekiwanego rachunku.

60
kredytów miesięcznie w planie darmowym
2,000
kredytów miesięcznie w planie Pro
Zobacz cennik kredytów

Dokumentacja

Pytania zadawane przez programistów

Czy API SpeakNotes jest darmowe?
Każde konto otrzymuje 60 kredytów miesięcznie bezpłatnie, a klucze sandbox są nielimitowane i darmowe na zawsze. Konta Pro otrzymują 2000 kredytów miesięcznie. Po wyczerpaniu miesięcznego przydziału można dokupić pakiety przedpłaconych kredytów.
Jak uzyskać klucz API SpeakNotes?
Zaloguj się i otwórz Ustawienia, a następnie Klucze API. Klucz tworzysz samodzielnie i działa on natychmiast. Nie ma procesu aplikacyjnego ani formularza kontaktowego.
Czy SpeakNotes posiada środowisko sandbox?
Tak. Każdy klucz utworzony z opcją sandbox zaczyna się od sn_test_. Obsługuje on każdą ścieżkę i zwraca stałe, realistyczne dane wyjściowe bez wywoływania modelu, zużywania kredytów czy zapisywania w Twoich rzeczywistych notatkach.
Jak połączyć SpeakNotes z Claude lub innym klientem MCP?
Skieruj klienta na adres https://api.speaknotes.io/mcp przez Streamable HTTP. Klienci obsługujący OAuth rejestrują się samodzielnie i proszą o autoryzację; klienci, którzy tego nie robią, mogą wysłać klucz API SpeakNotes jako token bearer.
Czy API SpeakNotes obsługuje OAuth?
Tak. SpeakNotes uruchamia serwer autoryzacji OAuth 2.1 z PKCE, rotacją tokenów odświeżania, dynamiczną rejestracją klientów i unieważnianiem. Metadane są publikowane pod adresem https://speaknotes.io/.well-known/oauth-authorization-server.
Jakie są limity zapytań API SpeakNotes?
120 zapytań typu odczyt, 30 zapytań typu zapis i 10 zapytań przetwarzania na minutę, liczone dla każdego poświadczenia. Każda odpowiedź zawiera pozostały budżet w nagłówkach limitów, a błąd 429 dokładnie informuje, jak długo należy czekać.