SonaNote

用 SonaNote 构建。

在脚本、AI 应用和自动化中读取转录。公开资料无需密钥，工作区访问使用个人 API token。

Chrome 扩展

下载扩展压缩包，解压后在 Chrome 扩展管理页启用开发者模式并加载文件夹。打开 YouTube 的“显示转录稿”，再点击扩展中的 Import visible YouTube captions，即可导入字幕并生成私有笔记。扩展只在你主动点击时读取当前标签页。

下载 Chrome 扩展

REST API

GET https://sonanote.space/api/media/transcripts GET /api/media/transcripts/ID GET /api/media/transcripts/ID/download?format=md

个人工作区

在工作区“连接应用”中生成只读或可消耗额度的 token，作为 Bearer 发送。只有可写 token 可以启动任务。

Authorization: Bearer bn_…

GET /api/media/workspace
POST /api/media/transcribe
{ "url": "https://…", "visibility": "private" }

GET /api/media/jobs/JOB_ID
POST /api/media/transcripts/ID/ask
{ "value": "What are the key ideas?" }

MCP

公共端点提供只读 get_transcript。附加工作区 token 后，还可列出资料与启动转录。

{
  "mcpServers": {
    "bloomnote": {
      "url": "https://sonanote.space/api/media/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

任务与错误

queued → processing → done / failed. 401: sign in. 403: forbidden. 402: credits exhausted. 409: concurrency limit. 413: file too large. 失败任务退还预留额度。新任务会消耗额度，即使已有订阅，也请检查调用前的余额。

媒体工具

GET /api/media/tools POST /api/media/upload (multipart: file, tool, parameters)

媒体文件属于当前会话或账号。任务完成后只提供私有下载链接，约 90 分钟后过期。