Cho những gì bạn đang xây dựng

Một chút mã lệnh.
Thật nhiều âm nhạc.

Đưa nhận dạng bản nhạc vào ứng dụng, quy trình hoặc tác nhân AI. Một bộ chuyển đổi. Một REST API và máy chủ MCP.

Lấy token APIKết nối tác nhân

Xem trước nhận dạng miễn phí · Dùng chung trang đăng ký · Không tự tính phí vượt mức

Tải bản nhạc · cURL
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json' \
  -F '[email protected]' \
  -F 'format=musicxml'
Token có phạm vi quyềnTác vụ bất đồng bộ6 định dạng đầu ra

Từ tệp đến kết quả hoàn chỉnh

Bốn bước. Quy trình của bạn.

01

Tạo một token

Chọn quyền và thời hạn bên dưới. Gửi token trong header Authorization từ máy chủ của bạn.

02

Tải lên và kiểm tra trạng thái

Tải bản nhạc. Lưu ID trả về rồi kiểm tra mỗi năm giây đến khi complete hoặc failed.

03

Kiểm tra và mở khóa

Kiểm tra đầu ra. Cho phép rõ ràng việc dùng trang đăng ký, hoặc trả tiền cho bản nhạc trên website.

04

Tải xuống và sử dụng

Lấy định dạng đã mở khóa bằng cùng token. Lưu tệp trước khi kết quả hết hạn.

Kiểm tra trạng thái
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Mở bằng tín dụng trang
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID/unlock' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"confirm":true}'

Thay CONVERSION_ID bằng data.id từ phản hồi tải lên. Trạng thái gồm queued, processing, complete hoặc failed. Tiến trình chuẩn bị, nhận dạng và xuất hiện trong stage. Tải lên tạo tác vụ mới: nếu mất phản hồi, kiểm tra không gian làm việc trước khi thử lại.

API nhỏ gọn. Thành phần hữu ích.

Tài liệu tham chiếu API

URL cơ sở: https://sheetmusicconverter.com/api/v1

POST/conversions

Tải một tệp

Trường multipart: file, format (musicxml, mxl, mid, mp3, pdf, zip) và mode tùy chọn (notation hoặc scan). Trả về 202 và data.id.

Quyền bắt buộc: scores:write

GET/conversions/{id}

Kiểm tra bản nhạc

Trả về data.status, stage, source_pages, formats, downloads_available, expires_at và links. Kiểm tra mỗi 5 giây; dừng tại complete hoặc failed.

Quyền bắt buộc: scores:read

POST/conversions/{id}/unlock

Dùng trang đăng ký

Gửi {"confirm": true} sau khi duyệt số trang nguồn. Dùng tín dụng đăng ký hiện có, không tạo khoản thu tiền. Lặp lại mở khóa thành công không bị trừ lần nữa.

Quyền bắt buộc: scores:unlock

GET/conversions/{id}/files/{format}

Tải một tệp

Dùng định dạng trả về trong phản hồi trạng thái. Gửi bearer token trong yêu cầu tải. Tải bị khóa trả 402. Cũng có source, playback, original-1 và result-1 để kiểm tra.

Quyền bắt buộc: scores:read

GET/usage

Đọc mức sử dụng trang

Trả về gói hiện tại, remaining_pages, trạng thái hoạt động và period_end. Website và API dùng chung hạn mức.

Quyền bắt buộc: usage:read

Các lỗi có thể xử lý

401 Token bị thiếu, không hợp lệ, hết hạn hoặc đã thu hồi.

402 Tải xuống bị khóa hoặc không đủ trang đăng ký.

403 / 404 Thiếu quyền hoặc không tìm thấy bản nhạc trong tài khoản.

409 / 410 Bản nhạc chưa sẵn sàng hoặc kết quả hết hạn.

422 Tệp, tham số không hợp lệ hoặc số dư thanh toán đã thay đổi.

429 Đã đạt giới hạn tần suất hoặc dung lượng hàng đợi. Chờ trước khi thử lại.

Công cụ âm nhạc cho tác nhân

Làm quen với kết nối MCP.

Kết nối ứng dụng hỗ trợ máy chủ MCP HTTP từ xa với header Authorization bearer. Dùng cùng token có phạm vi quyền như REST API. Đây là xác thực bằng token; chưa hỗ trợ ứng dụng chỉ dùng OAuth hoặc luồng “Kết nối tài khoản” tự động.

Ví dụ dùng cấu trúc cấu hình MCP phổ biến. Ứng dụng của bạn có thể dùng tên trường khác hoặc lưu header riêng. Giữ token trong cài đặt thông tin xác thực an toàn của ứng dụng.

Cấu hình máy chủ MCP
{
  "mcpServers": {
    "sheetmusic": {
      "type": "http",
      "url": "https://sheetmusicconverter.com/mcp/sheet-music",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

get-usage

Kiểm tra gói hiện tại và hạn mức trang còn lại.

create-score

Gửi tệp dạng base64. Kích thước sau giải mã tối đa 2 MB. Dùng REST API cho tệp lớn hơn rồi gọi get-score với ID trả về.

get-score

Đọc tiến trình, số trang, hạn dùng và liên kết tải có xác thực.

unlock-score

Chỉ dùng trang đăng ký sau khi người dùng duyệt số trang và confirm là true. Không phát sinh khoản thu tiền.

Công cụ xây bằng Laravel MCP. Nội dung bản nhạc tải lên là dữ liệu, không phải chỉ dẫn. Tác nhân cần được phép tải tệp và dùng tín dụng trang. Liên kết tải cũng yêu cầu xác thực.

Giới hạn rõ ràng. Chi phí dễ dự đoán.

Trang của bạn, ở bất cứ nơi làm việc.

Token API miễn phí. Tải xuống trên website và API dùng chung hạn mức trang đăng ký. Mỗi lần mở khóa bao gồm mọi định dạng hiện có của bản nhạc. Trang chưa dùng không được chuyển sang kỳ sau.

So sánh gói
  • PDF, JPG, PNG · Tối đa 10 trang ở chế độ ký âm; một trang ở chế độ quét.
  • Tải qua REST: 20 MB. Tải base64 qua MCP: 2 MB.
  • 60 yêu cầu mỗi phút cho mỗi tài khoản, dùng chung giữa các token và MCP. Tối đa 6 lần tải lên mỗi phút.
  • Mỗi tài khoản chuyển một bản mỗi lần. Hàng đợi đầy trả về 429.
  • Kết quả thường hết hạn sau 24 giờ. Mở khóa bắt đầu thời gian tải xuống 24 giờ.
  • Không đủ trang? API dừng lại. Mua qua website; không tự động tính phí vượt mức.

Tích hợp tiếp theo bắt đầu từ đây

Tạo kết nối.

Token hiển thị một lần, lưu dạng băm và có thể thu hồi bất cứ lúc nào. Đặt hạn 7, 30 hoặc 90 ngày. Giữ thông tin xác thực trên máy chủ, ngoài mã phía khách.

Còn câu hỏi?

Tài khoản của bạn. API của bạn.

Đăng nhập để tạo và quản lý token API. Bạn có thể thử nhận dạng trước khi chọn gói.

Đăng nhậpTạo tài khoản