Utwórz token
Poniżej wybierz uprawnienia i termin wygaśnięcia. Wysyłaj token z serwera w nagłówku Authorization.
Dla tego, co budujesz
Odrobina kodu.
Mnóstwo muzyki.
Dodaj rozpoznawanie nut do aplikacji, procesu pracy lub agenta AI. Jeden silnik konwersji. REST API i serwer MCP.
Bezpłatne podglądy rozpoznawania · Wspólne strony subskrypcji · Bez automatycznych dopłat
Prześlij partyturę · 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'Tokeny z zakresem uprawnieńZadania asynchroniczne6 formatów wyjściowych
Od pliku do gotowego wyniku
Cztery kroki. Twój sposób pracy.
Prześlij i sprawdzaj status
Prześlij partyturę. Zapisz zwrócony ID i sprawdzaj status co pięć sekund aż do complete lub failed.
Sprawdź i odblokuj
Sprawdź wynik. Wyraźnie zatwierdź użycie stron subskrypcji lub zapłać za partyturę na stronie.
Pobierz i używaj
Pobierz odblokowany format tym samym tokenem. Zapisz pliki przed wygaśnięciem wyniku.
Sprawdź status
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Accept: application/json'Odblokuj za strony
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}'Zastąp CONVERSION_ID wartością data.id z odpowiedzi przesyłania. Statusy to queued, processing, complete lub failed. Postęp przygotowania, rozpoznawania i eksportu pojawia się w stage. Przesłanie tworzy nowe zadanie: jeśli odpowiedź zaginie, sprawdź miejsce pracy przed ponowną próbą.
Małe API. Przydatne elementy.
Dokumentacja API
Bazowy URL: https://sheetmusicconverter.com/api/v1
POST/conversions
Prześlij jeden plik
Pola multipart: file, format (musicxml, mxl, mid, mp3, pdf, zip) oraz opcjonalne mode (notation lub scan). Zwraca 202 i data.id.
Wymagane uprawnienie: scores:write
GET/conversions/{id}
Sprawdź partyturę
Zwraca data.status, stage, source_pages, formats, downloads_available, expires_at i links. Sprawdzaj co 5 sekund; zatrzymaj przy complete lub failed.
Wymagane uprawnienie: scores:read
POST/conversions/{id}/unlock
Użyj stron z subskrypcji
Po zatwierdzeniu liczby stron źródłowych wyślij {"confirm": true}. Zużywa dostępne strony subskrypcji; nigdy nie tworzy opłaty pieniężnej. Powtórzenie udanego odblokowania nie zużywa stron ponownie.
Wymagane uprawnienie: scores:unlock
GET/conversions/{id}/files/{format}
Pobierz plik
Użyj formatu zwróconego w odpowiedzi statusu. Dodaj token bearer do żądania pobierania. Zablokowane pobieranie zwraca 402. Do sprawdzenia dostępne są też source, playback, original-1 i result-1.
Wymagane uprawnienie: scores:read
GET/usage
Odczytaj wykorzystanie stron
Zwraca aktualny plan, remaining_pages, status aktywności i period_end. Strona i API współdzielą limit.
Wymagane uprawnienie: usage:read
Błędy, które możesz obsłużyć
401 Brak tokena albo token nieprawidłowy, wygasły lub unieważniony.
402 Pobieranie zablokowane lub za mało stron subskrypcji.
403 / 404 Brak uprawnienia lub nie znaleziono partytury na Twoim koncie.
409 / 410 Partytura nie jest gotowa lub wynik wygasł.
422 Nieprawidłowy plik, parametry lub zmienione saldo płatności.
429 Osiągnięto limit żądań lub pojemność kolejki. Odczekaj przed ponowną próbą.
Narzędzia muzyczne dla Twojego agenta
Poznaj połączenie MCP.
Podłącz klienta obsługującego zdalny serwer MCP przez HTTP z nagłówkiem Authorization bearer. Użyj tego samego tokena z zakresem uprawnień co w REST API. Jest to uwierzytelnianie tokenem; klienci wyłącznie OAuth i automatyczne procesy „Połącz konto” nie są obsługiwane.
Przykład używa typowej struktury konfiguracji MCP. Twój klient może używać innych nazw pól lub przechowywać nagłówki osobno. Zachowaj token w bezpiecznych ustawieniach poświadczeń klienta.
Konfiguracja serwera MCP
{
"mcpServers": {
"sheetmusic": {
"type": "http",
"url": "https://sheetmusicconverter.com/mcp/sheet-music",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}get-usage
Sprawdź aktualny plan i pozostały limit stron.
create-score
Prześlij plik jako base64. Maksymalny rozmiar po dekodowaniu: 2 MB. Większe pliki wysyłaj przez REST API, a następnie użyj get-score ze zwróconym ID.
get-score
Odczytaj postęp, liczbę stron, termin wygaśnięcia i uwierzytelnione linki pobierania.
unlock-score
Użyj stron z subskrypcji dopiero po zatwierdzeniu ich liczby przez użytkownika i ustawieniu confirm na true. Nie powoduje to naliczenia opłat pieniężnych.
Narzędzia korzystają z Laravel MCP. Treść przesłanych nut to dane, nie instrukcje. Agent potrzebuje zgody na przesłanie pliku i zużycie stron. Linki pobierania także wymagają uwierzytelnienia.
Jasne limity. Przewidywalne koszty.
Twoje strony, gdziekolwiek pracujesz.
Tokeny API są bezpłatne. Pobieranie przez stronę i API korzysta z tego samego limitu stron subskrypcji. Jedno odblokowanie obejmuje wszystkie dostępne formaty danej partytury. Niewykorzystane strony nie przechodzą na kolejny okres.
Porównaj plany- PDF, JPG, PNG · Do 10 stron w trybie nut; jedna strona w trybie skanu.
- Przesyłanie REST: 20 MB. Przesyłanie base64 przez MCP: 2 MB.
- 60 żądań na minutę na konto, wspólnie dla tokenów i MCP. Maksymalnie 6 przesłanych plików na minutę.
- Jedna konwersja naraz na konto. Pełna kolejka zwraca 429.
- Wyniki zwykle wygasają po 24 godzinach. Odblokowanie rozpoczyna 24-godzinny okres pobierania.
- Za mało stron? API zatrzyma się. Kup na stronie; bez automatycznych dopłat.
Tutaj zaczyna się Twoja kolejna integracja
Nawiąż połączenie.
Tokeny są wyświetlane raz, przechowywane jako skróty i można je unieważnić w dowolnym momencie. Ustaw ważność na 7, 30 lub 90 dni. Trzymaj poświadczenia na serwerze, poza kodem klienta.
Więcej pytań?Twoje konto. Twoje API.
Zaloguj się, aby tworzyć tokeny API i zarządzać nimi. Możesz przetestować rozpoznawanie przed wyborem planu.