للأشياء التي تبنيها

قليل من البرمجة.
كثير من الموسيقى.

أضف التعرّف على النوتات الموسيقية إلى تطبيقك أو سير عملك أو وكيل الذكاء الاصطناعي. محرك تحويل واحد. 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

عنوان 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 لديك.

اربط عميلاً يدعم خادم MCP بعيداً عبر HTTP وترويسة 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 ميغابايت. استخدم REST API للملفات الأكبر، ثم get-score بالمعرّف المُعاد.

get-score

اقرأ التقدّم وعدد الصفحات وتاريخ الانتهاء وروابط التنزيل الموثّقة.

unlock-score

استخدم صفحات الاشتراك فقط بعد موافقة المستخدم على عدد الصفحات وتعيين confirm إلى true. لا تُنشأ رسوم نقدية.

الأدوات مبنية باستخدام Laravel MCP. محتوى النوتة المرفوعة بيانات وليس تعليمات. يحتاج وكيلك إلى إذن لرفع الملف واستهلاك رصيد الصفحات. تتطلب روابط التنزيل المصادقة أيضاً.

حدود واضحة. تكاليف متوقعة.

صفحاتك، أينما تعمل.

رموز API مجانية. تستخدم تنزيلات الموقع وAPI رصيد صفحات الاشتراك نفسه. يتيح فتح نوتة واحدة جميع صيغها المتاحة. لا تُرحّل الصفحات غير المستخدمة.

مقارنة الخطط

PDF وJPG وPNG · حتى 10 صفحات في وضع التدوين؛ وصفحة واحدة في وضع المسح.
رفع REST: ‏20 ميغابايت. رفع MCP بصيغة base64: ‏2 ميغابايت.
60 طلباً في الدقيقة لكل حساب، مشتركة بين الرموز وMCP. حتى 6 عمليات رفع في الدقيقة.
تحويل واحد في كل مرة لكل حساب. تعيد قائمة الانتظار الممتلئة الحالة 429.
تنتهي النتائج عادةً بعد 24 ساعة. يبدأ فتح النتيجة نافذة تنزيل مدتها 24 ساعة.
الصفحات غير كافية؟ تتوقف API. اشترِ عبر الموقع؛ لا توجد رسوم تجاوز تلقائية.

يبدأ تكاملك القادم هنا

أنشئ اتصالاً.

تظهر الرموز مرة واحدة، وتُخزّن كتجزئات، ويمكن إلغاؤها في أي وقت. حدّد صلاحية 7 أو30 أو90 يوماً. احتفظ ببيانات الاعتماد على خادمك خارج شيفرة العميل.

مزيد من الأسئلة؟

حسابك. واجهة API الخاصة بك.

سجّل الدخول لإنشاء رموز API وإدارتها. يمكنك اختبار التعرّف قبل اختيار خطة.

تسجيل الدخول إنشاء حساب

قليل من البرمجة.كثير من الموسيقى.