토큰 만들기
아래에서 권한과 만료일을 선택하세요. 서버에서 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를 저장하고 complete 또는 failed가 될 때까지 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
파일 하나 업로드
멀티파트 필드: 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, 활성 상태, period_end를 반환합니다. 웹사이트와 API는 동일한 제공량을 공유합니다.
필요한 권한: usage:read
처리 가능한 오류
401 토큰이 없거나 잘못되었거나 만료되었거나 폐기되었습니다.
402 다운로드가 잠겨 있거나 구독 페이지가 부족합니다.
403 / 404 권한이 없거나 계정에서 악보를 찾을 수 없습니다.
409 / 410 악보가 준비되지 않았거나 결과가 만료되었습니다.
422 잘못된 파일, 매개변수 또는 변경된 결제 잔액입니다.
429 요청 속도 제한 또는 대기열 용량에 도달했습니다. 잠시 기다린 후 다시 시도하세요.
에이전트용 음악 도구
MCP 연결을 만나보세요.
Authorization Bearer 헤더를 지원하는 원격 HTTP MCP 클라이언트를 연결하세요. 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로 제출하세요. 디코딩 후 최대 크기는 2MB입니다. 더 큰 파일은 REST API로 업로드한 뒤 반환된 ID로 get-score를 호출하세요.
get-score
진행 상황, 페이지 수, 만료일 및 인증된 다운로드 링크를 조회합니다.
unlock-score
사용자가 페이지 수를 승인하고 confirm이 true인 경우에만 구독 페이지를 사용하세요. 금전 청구는 발생하지 않습니다.
도구는 Laravel MCP로 구축되었습니다. 업로드된 악보 내용은 지시가 아닌 데이터입니다. 에이전트에는 파일 업로드와 페이지 크레딧 사용에 대한 허가가 필요합니다. 다운로드 링크에도 인증이 필요합니다.
명확한 한도. 예측 가능한 비용.
어디서 작업하든 함께하는 페이지.
API 토큰은 무료입니다. 웹사이트와 API 다운로드는 동일한 구독 페이지 한도를 사용합니다. 한 번 구매하면 해당 악보의 모든 제공 형식을 이용할 수 있습니다. 미사용 페이지는 이월되지 않습니다.
요금제 비교- PDF, JPG, PNG · 악보 모드 최대 10페이지, 스캔 모드 1페이지.
- REST 업로드: 20MB. MCP base64 업로드: 2MB.
- 계정당 분당 60회 요청이며 토큰과 MCP가 한도를 공유합니다. 업로드는 분당 최대 6회입니다.
- 계정당 한 번에 하나의 변환만 가능합니다. 대기열이 가득 차면 429를 반환합니다.
- 결과는 일반적으로 24시간 후 만료됩니다. 잠금 해제 시 24시간의 다운로드 기간이 시작됩니다.
- 페이지가 부족한가요? API는 중단됩니다. 웹사이트에서 구매하세요. 자동 초과 청구는 없습니다.
다음 연동이 여기서 시작됩니다
연결해 보세요.
토큰은 한 번만 표시되고 해시로 저장되며 언제든지 폐기할 수 있습니다. 만료일을 7일, 30일 또는 90일로 설정하세요. 자격 증명은 클라이언트 코드가 아닌 서버에 보관하세요.
다른 질문이 있으신가요?