Για όσα δημιουργείτε

Λίγος κώδικας.
Πολλή μουσική.

Εντάξτε την αναγνώριση παρτιτούρας στην εφαρμογή, τη ροή εργασίας ή τον πράκτορα AI σας. Μία μηχανή μετατροπής. Ένα REST API και ένας διακομιστής MCP.

Αποκτήστε διακριτικό APIΣυνδέστε έναν πράκτορα

Δωρεάν προεπισκοπήσεις αναγνώρισης · Κοινές σελίδες συνδρομής · Χωρίς αυτόματες υπερβάσεις

Μεταφόρτωση παρτιτούρας · 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 μορφές εξόδου

Από αρχείο σε ολοκληρωμένο αποτέλεσμα

Τέσσερα βήματα. Η δική σας ροή εργασίας.

01

Δημιουργία διακριτικού

Επιλέξτε δικαιώματα και λήξη παρακάτω. Στείλτε το διακριτικό στην κεφαλίδα Authorization από τον διακομιστή σας.

02

Μεταφόρτωση και περιοδικός έλεγχος

Ανεβάστε μια παρτιτούρα. Αποθηκεύστε το ID που επιστρέφεται και έπειτα ελέγχετε την κατάστασή της κάθε πέντε δευτερόλεπτα μέχρι να ολοκληρωθεί ή να αποτύχει.

03

Έλεγχος και ξεκλείδωμα

Ελέγξτε το αποτέλεσμα. Εγκρίνετε ρητά τη χρήση σελίδων συνδρομής ή πληρώστε την παρτιτούρα στον ιστότοπο.

04

Λήψη και χρήση

Ανακτήστε ξεκλειδωμένη μορφή με το ίδιο διακριτικό. Αποθηκεύστε τα αρχεία πριν λήξει το αποτέλεσμα.

Έλεγχος κατάστασης
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 και μετά το get-score με το ID που επιστράφηκε.

get-score

Διαβάστε πρόοδο, αριθμό σελίδων, λήξη και συνδέσμους λήψης με ταυτοποίηση.

unlock-score

Χρησιμοποίησε σελίδες συνδρομής μόνο αφού ο χρήστης εγκρίνει τον αριθμό σελίδων και το confirm είναι true. Δεν δημιουργούνται χρηματικές χρεώσεις.

Τα εργαλεία έχουν δημιουργηθεί με Laravel MCP. Το περιεχόμενο της ανεβασμένης παρτιτούρας είναι δεδομένα, όχι οδηγίες. Ο πράκτοράς σας χρειάζεται άδεια για να ανεβάσει το αρχείο και να καταναλώσει μονάδες σελίδων. Οι σύνδεσμοι λήψης απαιτούν επίσης έλεγχο ταυτότητας.

Σαφή όρια. Προβλέψιμο κόστος.

Οι σελίδες σου, όπου κι αν δουλεύεις.

Τα διακριτικά API είναι δωρεάν. Οι λήψεις μέσω ιστοτόπου και API χρησιμοποιούν το ίδιο όριο σελίδων συνδρομής. Ένα ξεκλείδωμα περιλαμβάνει κάθε διαθέσιμη μορφή της παρτιτούρας. Οι αχρησιμοποίητες σελίδες δεν μεταφέρονται.

Σύγκριση προγραμμάτων
  • PDF, JPG, PNG · Έως 10 σελίδες στη λειτουργία σημειογραφίας· μία σελίδα στη λειτουργία σάρωσης.
  • Μεταφορτώσεις REST: 20 MB. Μεταφορτώσεις MCP base64: 2 MB.
  • 60 αιτήματα ανά λεπτό ανά λογαριασμό, συνολικά για τα διακριτικά και το MCP. Έως 6 μεταφορτώσεις ανά λεπτό.
  • Μία μετατροπή κάθε φορά ανά λογαριασμό. Γεμάτη ουρά επιστρέφει 429.
  • Τα αποτελέσματα συνήθως λήγουν μετά από 24 ώρες. Το ξεκλείδωμα ξεκινά παράθυρο λήψης 24 ωρών.
  • Δεν επαρκούν οι σελίδες; Το API σταματά. Αγοράστε μέσω ιστοτόπου· χωρίς αυτόματες χρεώσεις υπέρβασης.

Η επόμενη ενσωμάτωσή σου ξεκινά εδώ

Δημιουργήστε μια σύνδεση.

Τα διακριτικά εμφανίζονται μία φορά, αποθηκεύονται ως κατακερματισμένες τιμές και μπορούν να ανακληθούν οποιαδήποτε στιγμή. Ορίστε λήξη σε 7, 30 ή 90 ημέρες. Διατηρείτε τα διαπιστευτήρια στον διακομιστή σας, εκτός του κώδικα του πελάτη.

Περισσότερες ερωτήσεις;

Ο λογαριασμός σου. Το API σου.

Συνδεθείτε για να δημιουργήσετε και να διαχειριστείτε διακριτικά API. Μπορείτε να δοκιμάσετε την αναγνώριση πριν επιλέξετε πακέτο.

ΣύνδεσηΔημιουργία λογαριασμού