创建令牌
在下方选择权限和有效期。从您的服务器通过 Authorization 请求头发送令牌。
为您正在构建的项目
少量代码。
更多音乐。
将乐谱识别接入您的应用、工作流程或 AI 智能体。同一个转换引擎，提供 REST API 和 MCP 服务器。
免费识别预览 · 共用订阅页数 · 不自动收取超额费用
上传乐谱 · 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'具有特定权限的令牌异步任务6 种输出格式
从文件到完整结果
四个步骤，融入您的工作流程。
上传与轮询
上传乐谱，保存返回的 ID，然后每 5 秒轮询状态，直到完成或失败。
检查并解锁
检查输出后，明确确认使用订阅页数，或在网站上为该乐谱付费。
下载与使用
使用同一令牌获取已解锁的格式。请在结果到期前保存文件。
检查状态
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Accept: application/json'使用页数额度解锁
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}'将 CONVERSION_ID 替换为上传响应中的 data.id。状态包括 queued、processing、complete 或 failed。stage 显示准备、识别和导出进度。每次上传会创建新任务：如果响应丢失，请先检查工作区再重试。
精简的 API，实用的构建模块。
API 参考
基础 URL：https://sheetmusicconverter.com/api/v1
POST/conversions
上传一个文件
Multipart 字段：file、format（musicxml、mxl、mid、mp3、pdf、zip），以及可选的 mode（notation 或 scan）。返回 202 和 data.id。
所需权限：scores:write
GET/conversions/{id}
检查乐谱
返回 data.status、stage、source_pages、formats、downloads_available、expires_at 和 links。每 5 秒轮询一次，状态为 complete 或 failed 时停止。
所需权限：scores:read
POST/conversions/{id}/unlock
使用订阅页数
确认原稿页数后发送 {"confirm": true}。此操作消耗可用订阅额度，不会产生金额扣款。重复已成功的解锁不会再次消耗额度。
所需权限：scores:unlock
GET/conversions/{id}/files/{format}
下载文件
使用状态响应中返回的格式，下载请求中须包含 bearer 令牌。未解锁的下载返回 402。source、playback、original-1 和 result-1 也可用于检查结果。
所需权限：scores:read
GET/usage
读取页数用量
返回当前套餐、remaining_pages、active 状态及 period_end。网站和 API 共用同一额度。
所需权限：usage:read
可处理的错误
401 令牌缺失、无效、已到期或已撤销。
402 下载尚未解锁，或订阅剩余页数不足。
403 / 404 缺少权限，或您的账户中找不到该乐谱。
409 / 410 乐谱尚未就绪，或结果已到期。
422 文件或参数无效，或结账余额已变化。
429 已达到请求频率或队列容量限制。请稍后重试。
为智能体提供音乐工具
认识您的 MCP 连接。
连接支持远程 HTTP MCP 服务器和 Authorization bearer 请求头的客户端。使用与 REST API 相同、具有特定权限的令牌。此方式采用令牌认证，不支持仅接受 OAuth 的客户端或自动“连接账户”流程。
示例采用常见的 MCP 配置结构。您的客户端可能使用不同的字段名，或单独存储请求头。请将令牌保存在客户端的安全凭据设置中。
MCP 服务器配置
{
"mcpServers": {
"sheetmusic": {
"type": "http",
"url": "https://sheetmusicconverter.com/mcp/sheet-music",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}get-usage
查看当前套餐与剩余页数额度。
create-score
以 base64 提交文件，解码后最大 2 MB。更大的文件请通过 REST API 上传，再使用返回的 ID 调用 get-score。
get-score
读取进度、页数、到期时间和需身份验证的下载链接。
unlock-score
仅在用户批准页数且 confirm 为 true 时使用订阅页数，不会产生金额扣款。
工具使用 Laravel MCP 构建。上传的乐谱内容是数据，不是指令。智能体上传文件和消耗页数额度都需要获得授权。下载链接同样需要身份验证。
- PDF、JPG、PNG · 记谱模式最多 10 页，扫描模式限一页。
- REST 上传：20 MB。MCP base64 上传：2 MB。
- 每个账户每分钟 60 次请求，令牌和 MCP 共用此额度。每分钟最多上传 6 次。
- 每个账户一次只能转换一个文件。队列已满时返回 429。
- 结果通常在 24 小时后到期。解锁后开始计算 24 小时下载期限。
- 页数不足时，API 会停止。请通过网站购买；不会自动收取超额费用。