Nền tảng nhà phát triển

Nền tảng API, máy chủ MCP và OAuth của SpeakNotes

Chuyển đổi âm thanh, video và liên kết YouTube thành bản ghi và tóm tắt có cấu trúc từ mã của riêng bạn, hoặc để một tác nhân AI thực hiện thông qua MCP. Mọi tài khoản đều có thể tạo khóa và bắt đầu trong sandbox miễn phí.

  • Tự tạo khóa trong bảng điều khiển. Không cần gọi điện cho bộ phận bán hàng, không cần danh sách chờ.
  • Các khóa sandbox trả về kết quả cố định, không tốn tín dụng và không bao giờ ảnh hưởng đến ghi chú thực của bạn.
  • Một máy chủ MCP được lưu trữ để Claude, ChatGPT và Cursor có thể sử dụng SpeakNotes một cách tự nhiên.

Ba yêu cầu để có bản tóm tắt đầu tiên của bạn

Bắt đầu với khóa sandbox để tìm hiểu cấu trúc, sau đó thay thế bằng khóa thực khi các phản hồi đã chính xác.

  1. 1

    Tạo khóa

    Mở Cài đặt, chọn Khóa API và tạo một khóa. Chọn sandbox để thử nghiệm hoặc chọn live để xử lý âm thanh thực.

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

    Gọi API

    Gửi khóa dưới dạng bearer token. Các bản tóm tắt, bản ghi chép và tác vụ YouTube sẽ trả về trực tiếp.

    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

    Tải lên tệp phương tiện lớn hơn

    Quá trình tải lên chạy trong nền: tạo yêu cầu tải lên, thực hiện PUT tệp, hoàn tất, sau đó kiểm tra ghi chú cho đến khi hoàn thành.

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

Những gì nền tảng cung cấp cho bạn

API REST hỗ trợ đọc và ghi

Liệt kê, tạo, cập nhật và xóa ghi chú và thư mục. Chuyển đổi âm thanh thành văn bản, tóm tắt văn bản và tóm tắt liên kết YouTube. Mọi thao tác đều nằm trong đặc tả OpenAPI 3.1.

Máy chủ MCP được lưu trữ

HTTP có thể truyền phát tại api.speaknotes.io/mcp, với mười ba công cụ bao gồm các thao tác đọc và ghi tương tự. Các tác nhân kết nối qua OAuth hoặc bằng khóa.

OAuth 2.1 với PKCE

Xây dựng ứng dụng thay mặt cho những người dùng SpeakNotes khác. Đăng ký ứng dụng khách động cho phép ứng dụng khách MCP tự đăng ký và kết nối mà không cần ai phải dán khóa.

Sandbox thực thụ

Các khóa bắt đầu bằng sn_test_ chạy mọi lộ trình, quy tắc xác thực và cấu trúc phản hồi dựa trên đầu ra cố định. Không tốn tín dụng, không gọi mô hình và các dữ liệu ghi sẽ nằm trong thư viện sandbox riêng biệt.

Tín dụng minh bạch

Một tín dụng tương đương với một phút phương tiện đã xử lý. Mọi phản hồi có tính phí đều trả về thông tin về số dư đã trừ và số dư còn lại, giúp tác nhân kiểm tra trước khi bắt đầu.

Thông tin xác thực theo phạm vi

Cấp cho khóa hoặc ứng dụng quyền hạn vừa đủ. Một khóa chỉ đọc có thể liệt kê ghi chú nhưng không bao giờ có thể xóa.

Giá cả

Mỗi tài khoản nhận được một lượng tín dụng hàng tháng được đặt lại. Tài khoản Pro nhận được lượng tín dụng lớn hơn nhiều. Ngoài ra, tín dụng được trả trước, vì vậy một vòng lặp thử lại không kiểm soát cũng không bao giờ làm phát sinh hóa đơn.

60
tín dụng mỗi tháng trên gói miễn phí
2,000
tín dụng mỗi tháng với gói Pro
Xem giá tín dụng

Tài liệu tham khảo

Các câu hỏi thường gặp của nhà phát triển

API SpeakNotes có miễn phí sử dụng không?
Mỗi tài khoản nhận được 60 tín dụng mỗi tháng miễn phí và các khóa sandbox là miễn phí vĩnh viễn không giới hạn. Tài khoản Pro nhận được 2.000 tín dụng mỗi tháng. Ngoài hạn mức hàng tháng, bạn có thể mua thêm các gói tín dụng trả trước.
Làm thế nào để tôi có được khóa API SpeakNotes?
Đăng nhập và mở Cài đặt, khóa API. Bạn tự tạo khóa và nó hoạt động ngay lập tức. Không có quy trình đăng ký và không cần biểu mẫu liên hệ.
SpeakNotes có môi trường sandbox không?
Có. Bất kỳ khóa nào bạn tạo với tùy chọn sandbox đều bắt đầu bằng sn_test_. Nó thực thi mọi lộ trình và trả về kết quả cố định, thực tế mà không cần gọi mô hình, tiêu tốn tín dụng hoặc ghi vào ghi chú thực của bạn.
Làm thế nào để tôi kết nối SpeakNotes với Claude hoặc một ứng dụng khách MCP khác?
Hướng ứng dụng khách tới https://api.speaknotes.io/mcp qua Streamable HTTP. Các ứng dụng khách hỗ trợ OAuth sẽ tự đăng ký và nhắc bạn ủy quyền; các ứng dụng khách không hỗ trợ có thể gửi khóa API SpeakNotes dưới dạng bearer token.
API SpeakNotes có hỗ trợ OAuth không?
Có. SpeakNotes chạy máy chủ ủy quyền OAuth 2.1 với PKCE, xoay vòng refresh token, đăng ký ứng dụng khách động và thu hồi. Siêu dữ liệu được xuất bản tại https://speaknotes.io/.well-known/oauth-authorization-server.
Giới hạn tốc độ của API SpeakNotes là bao nhiêu?
120 yêu cầu đọc, 30 yêu cầu ghi và 10 yêu cầu xử lý mỗi phút, được tính theo từng thông tin xác thực. Mỗi phản hồi đều mang theo ngân sách còn lại trong các tiêu đề giới hạn tốc độ của nó, và mã 429 cho bạn biết chính xác thời gian cần chờ.