SpeakNotesSpeakNotes
开始使用
开发者平台

SpeakNotes API、MCP 服务器和 OAuth 平台

通过您自己的代码将音频、视频和 YouTube 链接转换为转录文本和结构化摘要，或者通过 MCP 让 AI 智能体来完成。每个账户都可以免费创建密钥并在沙盒中开始使用。

  • 在仪表板中自行创建密钥。无需销售通话，无需等待名单。
  • 沙盒密钥返回固定输出，不消耗额度，且不会触及您的真实笔记。
  • 提供托管的 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 服务，包含 13 个工具，涵盖相同的读写操作。智能体可以通过 OAuth 或密钥进行连接。

支持 PKCE 的 OAuth 2.1

构建代表其他 SpeakNotes 用户操作的应用。动态客户端注册功能允许 MCP 客户端自行注册并连接，无需用户手动粘贴密钥。

真实的沙盒环境

以 sn_test_ 开头的密钥会针对固定输出运行所有路由、验证规则和响应格式。不消耗额度，不调用模型，写入操作仅保存在独立的沙盒库中。

透明的额度系统

1 个额度对应 1 分钟的媒体处理时长。每次收费的响应都会返回本次扣费金额及剩余额度，以便智能体在开始前进行检查。

作用域凭证

仅授予密钥或应用所需的权限。只读密钥可以列出笔记，但无法删除任何笔记。

定价

每个账户每月都会获得重置的额度。Pro 账户可获得更多额度。超出部分采用预付费模式，因此即使出现无限重试循环，也不会产生意外账单。

60
免费计划每月额度
2,000
Pro 计划每月额度
查看额度定价

参考文档

开发者常见问题

SpeakNotes API 可以免费使用吗？
每个账户每月可免费获得 60 个额度，沙盒密钥永久免费且无限制。Pro 账户每月可获得 2,000 个额度。超出每月免费额度后，您可以购买预付费额度包。
如何获取 SpeakNotes API 密钥？
登录后打开“设置”中的“API 密钥”页面。您可以自行创建密钥并立即使用。无需申请流程，也无需填写联系表单。
SpeakNotes 是否提供沙盒环境？
是的。任何使用沙盒选项创建的密钥都以 sn_test_ 开头。它会执行所有路由并返回固定且真实的输出，而无需调用模型、消耗额度或写入您的真实笔记。
如何将 SpeakNotes 连接到 Claude 或其他 MCP 客户端？
将客户端指向 https://api.speaknotes.io/mcp 并使用流式 HTTP。支持 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 错误，其中会明确告知您需要等待的时间。