לדברים שאתם בונים

קצת קוד.
הרבה מוזיקה.

שלבו זיהוי תווים באפליקציה, בתהליך העבודה או בסוכן ה־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 פורמטי פלט

מקובץ לתוצאה מוגמרת

ארבעה צעדים. תהליך העבודה שלכם.

יצירת אסימון

בחרו הרשאות ותוקף בהמשך. שלחו את האסימון בכותרת Authorization מהשרת שלכם.

העלאה ותשאול

העלו תווים. שמרו את המזהה שהוחזר, ואז תשאלו את המצב כל חמש שניות עד לסיום או לכישלון.

בדיקה ופתיחה להורדה

בדקו את הפלט. אשרו במפורש שימוש בעמודי מנוי, או שלמו על היצירה באתר.

הורדה ושימוש

הורידו פורמט שנפתח באמצעות אותו אסימון. שמרו את הקבצים לפני פקיעת התוצאה.

בדיקת מצב

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

כתובת בסיס: 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 עם המזהה שהוחזר.

get-score

קריאת התקדמות, מספר עמודים, פקיעה וקישורי הורדה המחייבים הזדהות.

unlock-score

השתמשו בעמודי מנוי רק לאחר שהמשתמש מאשר את מספר העמודים ו־confirm הוא true. לא נוצרים חיובים כספיים.

הכלים בנויים עם Laravel MCP. תוכן התווים שהועלה הוא נתונים, לא הוראות. הסוכן שלכם זקוק להרשאה להעלאת הקובץ ולניצול יתרת עמודים. גם קישורי הורדה דורשים הזדהות.

מגבלות ברורות. עלויות צפויות.

העמודים שלכם, בכל מקום שבו תעבדו.

אסימוני API הם בחינם. הורדות באתר וב־API משתמשות באותה מכסת עמודים של המנוי. פתיחה אחת כוללת כל פורמט זמין לאותה יצירה. עמודים שלא נוצלו אינם נצברים.

השוואת חבילות

PDF, JPG, PNG · עד 10 עמודים במצב תיווי; עמוד אחד במצב סריקה.
העלאות REST: עד 20 MB. העלאות base64 ב־MCP: עד 2 MB.
60 בקשות בדקה לכל חשבון, במשותף לכל האסימונים ול־MCP. עד 6 העלאות בדקה.
המרה אחת בכל פעם לכל חשבון. תור מלא מחזיר 429.
תוצאות פוקעות בדרך כלל אחרי 24 שעות. פתיחה להורדה מתחילה חלון הורדה של 24 שעות.
אין מספיק עמודים? ה־API עוצר. רכשו דרך האתר; אין חיובי חריגה אוטומטיים.

האינטגרציה הבאה שלכם מתחילה כאן

צרו חיבור.

אסימונים מוצגים פעם אחת, נשמרים כגיבובים וניתנים לביטול בכל עת. קבעו תוקף של 7, 30 או 90 ימים. שמרו אישורים בשרת, מחוץ לקוד צד לקוח.

שאלות נוספות?

החשבון שלכם. ה־API שלכם.

היכנסו כדי ליצור ולנהל אסימוני API. אפשר לבדוק את הזיהוי לפני בחירת חבילה.

כניסה יצירת חשבון

קצת קוד.הרבה מוזיקה.