SpeakNotesSpeakNotes
立即開始
開發者平台

SpeakNotes API、MCP 伺服器與 OAuth 平台

透過您自己的程式碼將音訊、影片和 YouTube 連結轉換為逐字稿與結構化摘要，或是讓 AI 代理程式透過 MCP 執行。每個帳戶皆可建立金鑰並免費在沙盒環境中開始使用。

  • 直接在儀表板中建立金鑰。無需銷售諮詢，無需排隊等待。
  • 沙盒金鑰會回傳固定輸出，不會消耗額度，且完全不會影響您的真實筆記。
  • 提供託管式 MCP 伺服器，讓 Claude、ChatGPT 和 Cursor 能夠原生使用 SpeakNotes。
建立 API 金鑰閱讀快速入門

三個請求即可完成您的第一份摘要

先使用沙盒金鑰來熟悉格式，當回應正確後再切換為正式金鑰。

  1. 1

    建立金鑰

    開啟「設定」中的「API 金鑰」並建立一個。選擇沙盒環境進行測試，或選擇正式環境來處理真實音訊。

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

    呼叫 API

    將金鑰作為 Bearer Token 發送。摘要、逐字稿和 YouTube 處理任務將會直接回傳。

    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

    上傳較長的媒體檔案

    上傳作業會在背景執行：建立上傳任務、PUT 檔案、完成上傳，然後輪詢筆記狀態直到處理完成。

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

平台為您提供的功能

具備讀寫功能的 REST API

列出、建立、更新與刪除筆記和資料夾。轉換音訊、摘要文字以及摘要 YouTube 連結。所有操作均符合 OpenAPI 3.1 規範。

託管式 MCP 伺服器

位於 api.speaknotes.io/mcp 的串流式 HTTP，包含十三種涵蓋相同讀寫操作的工具。代理程式可透過 OAuth 或金鑰進行連接。

支援 PKCE 的 OAuth 2.1

建構能代表其他 SpeakNotes 使用者執行動作的應用程式。動態用戶端註冊功能讓 MCP 用戶端能自行註冊並連接，無需任何人手動貼上金鑰。

真正的沙盒環境

以 sn_test_ 開頭的金鑰會針對固定輸出執行所有路由、驗證規則與回應格式。不消耗額度、不呼叫模型，且寫入的資料會存放在獨立的沙盒庫中。

您可以查看的點數

一個點數代表一分鐘的媒體處理時間。每次收費的請求都會回傳扣除的點數以及剩餘點數，因此代理程式可以在開始前進行檢查。

權限範圍憑證

僅授予金鑰或應用程式所需的權限。唯讀金鑰可以列出筆記，但永遠無法刪除筆記。

定價

每個帳戶每月都會獲得重置的點數配額。Pro 帳戶的配額則大得多。除此之外，點數皆為預付制，因此失控的重試迴圈永遠不會導致帳單暴增。

60
免費方案每月點數
2,000
Pro 方案每月點數
查看點數定價

參考資料

開發者常見問題

SpeakNotes API 可以免費使用嗎？
每個帳戶每月可免費獲得 60 點，沙盒金鑰則永久免費且無限制。Pro 帳戶每月可獲得 2,000 點。超出每月配額後，您可以購買預付點數包。
如何取得 SpeakNotes API 金鑰？
登入後開啟「設定」中的「API 金鑰」。您可以自行建立金鑰並立即使用。無需申請流程，也無需填寫聯絡表單。
SpeakNotes 有沙盒環境嗎？
有的。任何您使用沙盒選項建立的金鑰都會以 sn_test_ 開頭。它會執行所有路由並回傳固定的、真實的輸出，而不會呼叫模型、消耗點數或寫入您的真實筆記。
如何將 SpeakNotes 連接到 Claude 或其他 MCP 客戶端？
透過串流 HTTP 將客戶端指向 https://api.speaknotes.io/mcp。支援 OAuth 的客戶端會自行註冊並提示您授權；不支援的客戶端則可以將 SpeakNotes API 金鑰作為 bearer token 發送。
SpeakNotes API 支援 OAuth 嗎？
是的。SpeakNotes 執行一個支援 PKCE、重新整理權杖輪替、動態客戶端註冊與撤銷的 OAuth 2.1 授權伺服器。中繼資料發佈於 https://speaknotes.io/.well-known/oauth-authorization-server。
SpeakNotes API 的速率限制是多少？
每分鐘 120 次讀取請求、30 次寫入請求與 10 次處理請求，按憑證計算。每個回應都會在速率限制標頭中顯示剩餘額度，而 429 錯誤會明確告知您需要等待的時間。