API, server MCP, dan platform OAuth SpeakNotes
Ubah tautan audio, video, dan YouTube menjadi transkrip dan ringkasan terstruktur dari kode Anda sendiri, atau biarkan agen AI melakukannya melalui MCP. Setiap akun dapat membuat kunci dan memulai di sandbox secara gratis.
- Buat kunci sendiri di dasbor. Tanpa panggilan penjualan, tanpa daftar tunggu.
- Kunci sandbox memberikan output tetap, tidak menghabiskan kredit, dan tidak pernah menyentuh catatan asli Anda.
- Server MCP ter-host agar Claude, ChatGPT, dan Cursor dapat menggunakan SpeakNotes secara native.
Tiga permintaan menuju ringkasan pertama Anda
Mulailah dengan kunci sandbox untuk mempelajari bentuknya, lalu gunakan kunci live saat respons sudah sesuai.
- 1
Buat kunci
Buka Pengaturan, kunci API, dan buat satu. Pilih sandbox untuk mencoba, atau live untuk memproses audio asli.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
Panggil API
Kirim kunci sebagai bearer token. Ringkasan, transkripsi, dan pekerjaan YouTube akan dijawab secara 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
Unggah media yang lebih panjang
Unggahan berjalan di latar belakang: buat unggahan, lakukan PUT pada file, selesaikan, lalu polling catatan hingga selesai.
# 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"
Apa yang diberikan platform kepada Anda
REST API yang dapat membaca dan menulis
Daftar, buat, perbarui, dan hapus catatan serta folder. Transkripsikan audio, ringkas teks, dan ringkas tautan YouTube. Setiap operasi ada dalam spesifikasi OpenAPI 3.1.
Server MCP ter-host
HTTP yang dapat di-stream di api.speaknotes.io/mcp, dengan tiga belas alat yang mencakup operasi baca dan tulis yang sama. Agen terhubung melalui OAuth atau dengan kunci.
OAuth 2.1 dengan PKCE
Bangun aplikasi yang bertindak untuk pengguna SpeakNotes lainnya. Pendaftaran klien dinamis berarti klien MCP dapat mendaftarkan dirinya sendiri dan terhubung tanpa perlu menempelkan kunci.
Sandbox yang nyata
Kunci yang dimulai dengan sn_test_ menjalankan setiap rute, aturan validasi, dan bentuk respons terhadap output tetap. Tanpa kredit, tanpa panggilan model, dan hasil tulis masuk ke pustaka sandbox terpisah.
Kredit yang dapat Anda lihat
Satu kredit adalah satu menit media yang dimulai. Setiap respons yang berbayar akan mengembalikan informasi biaya dan sisa kredit, sehingga agen dapat memeriksa sebelum memulai.
Kredensial dengan cakupan (scoped)
Berikan kunci atau aplikasi hanya akses yang dibutuhkan. Kunci read-only dapat mencantumkan catatan dan tidak akan pernah menghapusnya.
Harga
Setiap akun mendapatkan hibah kredit bulanan yang akan diatur ulang. Akun Pro mendapatkan jumlah yang jauh lebih besar. Selain itu, kredit bersifat prabayar, sehingga loop percobaan ulang yang tidak terkendali tidak akan pernah menyebabkan tagihan membengkak.
Referensi
- Panduan cepatDari nol hingga ringkasan yang berfungsi, menggunakan curl.
- Autentikasi dan cakupanKunci API, kunci sandbox, cakupan, dan batas kecepatan.
- OAuth 2.1Kode otorisasi dengan PKCE, pendaftaran klien dinamis, refresh, dan pencabutan.
- Kode kesalahanSetiap kode yang dapat dikembalikan API dan apa yang harus dilakukan untuk masing-masing kode.
- Kredit dan hargaBerapa biaya setiap operasi, dan cara melakukan isi ulang.
- Spesifikasi OpenAPI 3.1Kontrak yang dapat dibaca mesin untuk setiap operasi.
- Manifest MCPNama server, transport, dan daftar alat di /.well-known/mcp.json.
- File keterampilan agenSKILL.md siap pakai untuk runtime agen.
Pertanyaan yang sering diajukan pengembang
- Apakah API SpeakNotes gratis untuk digunakan?
- Setiap akun mendapatkan 60 kredit per bulan tanpa biaya, dan kunci sandbox tidak terbatas serta gratis selamanya. Akun Pro mendapatkan 2.000 kredit per bulan. Di luar jatah bulanan tersebut, Anda dapat membeli paket kredit prabayar.
- Bagaimana cara mendapatkan kunci API SpeakNotes?
- Masuk ke akun Anda dan buka Pengaturan, lalu kunci API. Anda membuat kuncinya sendiri dan kunci tersebut langsung berfungsi. Tidak ada proses aplikasi dan tidak ada formulir kontak.
- Apakah SpeakNotes memiliki lingkungan sandbox?
- Ya. Kunci apa pun yang Anda buat dengan opsi sandbox dimulai dengan sn_test_. Kunci ini menjalankan setiap rute dan mengembalikan output tetap yang realistis tanpa memanggil model, menghabiskan kredit, atau menulis ke catatan asli Anda.
- Bagaimana cara menghubungkan SpeakNotes ke Claude atau klien MCP lainnya?
- Arahkan klien ke https://api.speaknotes.io/mcp melalui Streamable HTTP. Klien yang mendukung OAuth akan mendaftarkan diri dan meminta Anda untuk memberikan otorisasi; klien yang tidak mendukungnya dapat mengirimkan kunci API SpeakNotes sebagai bearer token.
- Apakah API SpeakNotes mendukung OAuth?
- Ya. SpeakNotes menjalankan server otorisasi OAuth 2.1 dengan PKCE, rotasi token refresh, pendaftaran klien dinamis, dan pencabutan. Metadata dipublikasikan di https://speaknotes.io/.well-known/oauth-authorization-server.
- Berapa batas kecepatan (rate limit) API SpeakNotes?
- 120 permintaan baca, 30 permintaan tulis, dan 10 permintaan pemrosesan per menit, dihitung per kredensial. Setiap respons membawa sisa kuota di header batas kecepatan, dan kode 429 memberi tahu Anda dengan tepat berapa lama harus menunggu.