डेवलपर चेंजलॉग

Flat अब https://mcp.flat.io/mcp पर एक रिमोट Model Context Protocol सर्वर चलाता है, जिससे कोई भी MCP क्लाइंट ग्राहक के Flat खाते में मौजूद स्वरलिपियों के साथ काम कर सकता है।

• शुरुआती चार टूल: search, score_get, score_export (MusicXML, कंप्रेस्ड MusicXML, MIDI) और score_create (MusicXML, MIDI, ABC, MuseScore, Guitar Pro)। मौजूदा स्वरलिपियों को कभी भी संपादित, डिलीट या सार्वजनिक नहीं किया जाता।
• PKCE के साथ OAuth 2.1, केवल एक mcp स्कोप, और Client ID Metadata Documents या Dynamic Client Registration के ज़रिए क्लाइंट पंजीकरण। API कुंजी की ज़रूरत नहीं: ग्राहक Flat की सहमति स्क्रीन पर हर क्लाइंट को मंज़ूरी देता है।
• इनके साथ काम करता है: Claude Code, Codex, Gemini CLI, Cursor और VS Code — सिर्फ़ एक कमांड या कॉन्फ़िगरेशन एंट्री के साथ।

कनेक्ट किए जाने वाले खाते में सक्रिय Flat Power सदस्यता ज़रूरी है। इस पहले संस्करण में स्वरलिपियाँ पढ़ने और बनाने की सुविधा है; हम developers@flat.io पर मिले आपके सुझावों के आधार पर टूल जोड़ेंगे।

पूरी गाइड: Flat MCP सर्वर।

Developer dashboard को इस आधार पर फिर से बनाया गया है कि आपका integration क्या कर सकता है। हर capability (Embed, OMR, REST API, Import API, LTI) के लिए उसकी scope, pricing और documentation के साथ एक कार्ड है, और जिन्हें आपका app पहले से इस्तेमाल करता है वे सबसे पहले दिखते हैं।

• Account स्तर पर एक नया OMR सेक्शन, जिसमें आपकी jobs, आपके credits और उनका history एक ही जगह पर है, क्योंकि OMR credits आपके सभी apps में साझा होते हैं।
• Code लिखने से पहले OMR आज़माएँ। Playground PDF या फ़ोटो लेता है, page count, प्रति पेज लागत और पुष्टि करने पर आपके पास कितना balance बचेगा यह दिखाता है, फिर आपकी पुष्टि के बाद job चलाता है। Output MusicXML download के रूप में जाता है, आपकी library में कुछ भी नहीं जोड़ा जाता।
• ज़्यादा स्पष्ट app pages। Personal tokens, OAuth2 credentials और OMR access को हर application के अनुसार समूहित किया गया है, और जिन credentials में OMR scope है उन्हें अलग से दिखाया गया है।

इसे flat.io/developers से खोलें।

हमारी REST API specification अब OpenAPI 3.1 पर जा रही है, OMR API का beta period खत्म हो रहा है, और Flat for Education में assignments अब सिर्फ listing और creating तक सीमित नहीं हैं।

• OMR API अब stable है। Endpoints, fields और behavior अब किसी भी breaking change से पहले हमारी सामान्य deprecation process का पालन करते हैं। एक नया FAQ credits और billing, limits और processing times, recognition quality और languages, तथा commercial use और privacy को कवर करता है।
• Flat for Education में assignments को read, update और delete करें। किसी assignment को delete करने पर उसकी submissions और students की copies भी हट जाती हैं; काम सुरक्षित रखना हो तो उसे delete करने के बजाय archive करें।
• Credit ledger. एक नया call आपके credit history को list करता है; balance OMR capabilities call पर ही रहता है।
• Finale files (.musx) import की जा सकती हैं, best-effort basis पर, और scanned music import (PDF और images) को score creation पर documented किया गया है।
• OpenAPI 3.1. Nullable fields अब 3.1 syntax का उपयोग करते हैं; OpenAPI 3.0 पर pinned tooling को update करना होगा। OMR file uploads से mimeType field हटा दी गई है।

• डेटा रिटेंशन अब आपके नियंत्रण में। OMR जॉब्स अब बताते हैं कि उनकी फ़ाइलें कितने समय तक रखी जाती हैं (डिफ़ॉल्ट रूप से 30 दिन), हर MusicXML जॉब में अब उसकी expiry date शामिल होती है, और आप किसी जॉब की फ़ाइलें और परिणाम उन्हें प्राप्त करते ही मिटा सकते हैं।
• साइन-इन से पहले फ़ीचर डिटेक्शन। OMR capabilities call बिना अकाउंट के भी काम करती है और समर्थित recognition languages को उनके नामों सहित सूचीबद्ध करती है।
• किसी भी score revision के लिए ABC notation export, MusicXML, MIDI और अन्य formats के साथ। MIDI की तरह, इसमें पूरी engraving शामिल नहीं होती।
• Flat for Education में Free Record assignments को API के ज़रिए कॉन्फ़िगर किया जा सकता है।
• किसी upstream provider (जैसे Google Classroom) से आने वाली errors में अब provider का अपना localized message भी शामिल होता है।

Flat का OMR इंजन अब developer API के ज़रिए प्रोग्रामेटिक रूप से उपलब्ध है। PDF या फ़ोटो भेजें, पहचान की प्रगति पर नज़र रखें, पहचाने गए वाद्ययंत्रों की समीक्षा करें, फिर परिणाम को Flat लाइब्रेरी में editable score के रूप में इम्पोर्ट करें या MusicXML या MIDI के रूप में एक्सपोर्ट करें। यही वही in-house model है जो editor में PDF और फ़ोटो import को संचालित करता है, और अब आपके अपने apps और workflows के लिए बड़े पैमाने पर उपलब्ध है।

समर्पित OMR API (v2.24.0), v2.23.0 में score creation में जोड़े गए background PDF import पर आधारित है: फ़ाइल import करते समय task support का अनुरोध करें और score तैयार होने तक task को poll करें। दोनों releases के विवरण के लिए API changelog देखें।

2024 के बाद का सबसे बड़ा specification अपडेट, जो API को उत्पाद में हुए दो वर्षों के बदलावों के अनुरूप लाता है।

• 15+ फ़ॉर्मैट से इम्पोर्ट। Guitar Pro, MuseScore, ABC notation, PowerTab, Capella, MEI, Overture, TablEdit, Band-in-a-Box, Karaoke MIDI, MuseData, Score Writer, Bagpipe Music Writer और Encore अब MusicXML और MIDI के साथ शामिल हैं, और scores को native .flat फ़ाइलों के रूप में export किया जा सकता है।
• वर्चुअल कलेक्शन। लाइब्रेरी में पुरानी folder hierarchy की जगह all scores, collaborations और likes लेते हैं, जो नए डिज़ाइन की गई Flat library से मेल खाते हैं।
• Flat for Education. ऑडियो या वीडियो रिकॉर्डिंग वाले performance assignment, साथ में backing track, metronome और speed विकल्प; साझा लेखन के लिए group submissions; rich text निर्देश; छात्र sub-groups; शेड्यूल किए गए और व्यक्तिगत रूप से लक्षित Microsoft Teams assignments; resource library में समृद्ध विवरण और assignment types।
• एकीकृत LTI configuration LTI 1.1 और 1.3 के लिए, जिसमें dynamic registration शामिल है। पहले वाले LTI 1.1 credentials calls अब deprecated हैं।
• scores पर वार्षिक आँकड़े, profiles पर public score counts, और कुछ लंबे समय से deprecated fields को हटाया गया है।

• ऑडियो एक्सपोर्ट के लिए getMP3 और getWAV मेथड जोड़े गए
• exportProgress इवेंट जोड़ा गया, ताकि लंबे एक्सपोर्ट की प्रगति दिखाई जा सके

• यूज़र स्कोर लिस्टिंग अब सार्वजनिक प्रोफ़ाइल हैं। किसी यूज़र के स्कोर की सूची अब केवल उसके सार्वजनिक स्कोर लौटाती है, साथ में नया pagination और sorting भी, जैसा बदलाव 2020 में घोषित किया गया था।
• स्कोर विवरण अब edit URL, instrument names और कोई निर्धारित deletion date दिखाते हैं; collections अपने scores की गिनती बताती हैं; public profiles में likes और plays की संख्या दिखाई जाती है।
• Flat for Education. resource library को assignment type, subject और grade के अनुसार फ़िल्टर करें; resources में sharing description और privacy capabilities होती हैं; assignments note playing और audio tracks को सीमित कर सकते हैं; submissions, LTI 1.1 और 1.3 grade services का समर्थन करती हैं।

• उपयोगकर्ता प्रोफ़ाइल पर लाइक अब पेजिनेटेड हैं, और खाता विवरण में यह भी दिखता है कि उपयोगकर्ता कौन-सा प्रोडक्ट इस्तेमाल कर रहा है।
• रिसोर्स अधिकार अब बताते हैं कि कॉलर मालिक है, उपयोगकर्ता सहयोगी है या समूह सहयोगी, साथ ही हर सहयोगी को कब जोड़ा गया था इसकी तारीख भी दिखाते हैं। स्कोर विवरण में अब मुख्य key signature, highlight तारीख और organization भी शामिल हैं।
• Flat for Education. आमंत्रणों का कई बार पुनः उपयोग किया जा सकता है; सबमिशन में अब graded state के साथ playback और LTI विवरण भी शामिल हैं; किसी assignment को resource library में तभी कॉपी किया जा सकता है जब वह पहले से वहाँ मौजूद न हो; organizations को अब अपनी अलग resource libraries मिलती हैं, जिनमें organization-wide privacy level होता है।

अपने कोड से लोड किए गए score की संरचना पढ़ें।

• Parts और voices: getNbParts, getPartsUuids, getMeasureVoicesUuids
• Notes: getMeasureNbNotes, getNoteData, playbackPositionToNoteIdx
• नया URL पैरामीटर noAudio audio playback को बंद करता है
• setMasterVolume द्वारा गलत underlying method कॉल करने की समस्या ठीक की गई

• constructor में jQuery का समर्थन हटा दिया गया — अब इसकी जगह DOM element या उसका id दें
• प्रकाशित npm module में TypeScript टाइप शामिल हैं
• अलग-अलग ES और UMD बिल्ड

• Flat for Education की resource library के आइटम से LTI लिंक बनाएँ, ताकि उन्हें सीधे किसी LMS course में रखा जा सके।
• किसी assignment का अधिकतम grade अब 100 से बढ़कर 10,000 points हो गया है।
• Score metadata (subtitle, composer, lyricist, arranger, description, license…) को अब API के ज़रिए सिर्फ सेट ही नहीं, बल्कि clear भी किया जा सकता है।

• Resource Library API (beta). Flat for Education की resource libraries को ब्राउज़ और प्रबंधित करें, जिसमें पूर्ण और केवल-पढ़ने की पहुँच के लिए दो नए OAuth2 scopes शामिल हैं। Assignments को resource library में कॉपी किया जा सकता है।
• Test students. किसी कक्षा में testing student accounts बनाएँ, ताकि assignments को उसी तरह आज़माया जा सके जैसा एक छात्र देखेगा।
• Assignments अब बताते हैं कि आप उनके साथ क्या कर सकते हैं (edit, publish, archive…), क्या उनके attachments समर्पित प्रतियां हैं, और कोई भी समस्या जो सामने आई हो। Submission history किसी बदलाव का स्रोत दर्ज करती है जब वह Google Classroom, Microsoft Teams या किसी LMS से आता है।
• किसी submission को reset करने पर वह हटने के बजाय अपनी जगह बना रहता है; class metadata (level, skills, size) और accounts पर Microsoft sign-in विवरण उपलब्ध कराए जाते हैं।
• Score revisions अब अपनी start और end dates लौटाते हैं; score builders quarter tones सक्षम कर सकते हैं; copies मूल title बनाए रख सकती हैं।

• Measures: getNbMeasures, getMeasuresUuids
• नेविगेशन: goLeft, goRight, scrollToCursor
• Metronome: getMetronomeMode, setMetronomeMode
• Playback speed: getPlaybackSpeed, setPlaybackSpeed

• Sign-in links और delegated access tokens. Flat for Education के एडमिन अपने संगठन के किसी भी user के लिए sign-in link बना सकते हैं, या ऐसा access token जो उस user की ओर से काम करे: यह custom portals और single sign-on integrations की बुनियाद है.
• hiragana में Japanese (ja-HIRA) अब supported locales में शामिल है; public comments अब अपनी moderation state दिखाते हैं.
• Audio exports अब MP3 set को default track के रूप में लौटाते हैं, जब वह मौजूद हो. केवल cached exports मांगने का विकल्प हटा दिया गया है, क्योंकि audio exports अब हमेशा cache से ही serve किए जाते हैं.

• Score builder. MusicXML फ़ाइल इम्पोर्ट किए बिना खाली स्कोर बनाएं: वाद्यों की एक सूची दें और, वैकल्पिक रूप से, time signature, key signature, tablature, chord grids और page layout भी दें।
• Flat for Education. संगठन के उपयोगकर्ताओं को किसी भूमिका के साथ बनाया जा सकता है; worksheets अपने exercises को shuffle कर सकती हैं; छात्र submissions उनमें शामिल exercises की सूची दिखाती हैं।

• प्लेबैक ट्रैक. उन ट्रैक की सूची प्राप्त करें जिन्हें Flat अपने-आप जनरेट और सिंक करता है (MP3 के रूप में प्लेबैक), नवीनतम प्लेबैक फ़ाइल के synchronization points प्राप्त करें, और response body में किसी export का CDN URL पाएँ.
• Flat for Education. शिक्षक किसी छात्र का submission reset कर सकते हैं; classes उन accounts की रिपोर्ट करती हैं जिन्हें sync के दौरान जोड़ा नहीं जा सका; assignments और submissions अपनी Microsoft Teams स्थिति और links दिखाते हैं; assignment copies को schedule किया जा सकता है; performance submissions अपनी saved audio track के साथ आती हैं.
• Profiles में अब cover picture जोड़ी गई है, और current user की id को अलग से प्राप्त किया जा सकता है.

• loadFlatScore अब sharingKey स्वीकार करता है, इसलिए निजी रूप से साझा किया गया स्कोर लोड किया जा सकता है
• ऑडियो ट्रैक को डायनेमिक रूप से सेट करने के लिए setTrack, useTrack और seekTrackTo जोड़े गए हैं

• ग्रेड एक्सपोर्ट। किसी असाइनमेंट के ग्रेड CSV या Excel फ़ाइल के रूप में डाउनलोड करें।
• असाइनमेंट अब अपना प्रकार और कवर इमेज रखते हैं; किसी असाइनमेंट को कॉपी करने पर किसी दूसरे असाइनमेंट की सामग्री से मौजूदा ड्राफ़्ट को ओवरराइट किया जा सकता है।
• सहयोगियों के लिए अब दिखाया जाता है कि उनका निमंत्रण अभी भी लंबित है या नहीं।

• API के ज़रिए ग्रेडिंग। ड्राफ्ट और अंतिम ग्रेड सेट करें, किसी छात्र को सबमिशन लौटाएँ, और गणना किए गए टिप्पणी काउंटर पढ़ें; अधिकतम अंक ग्रेड के साथ संग्रहीत किए जाते हैं।
• सबमिशन टिप्पणियाँ। किसी सबमिशन पर टिप्पणियाँ बनाएँ, सूचीबद्ध करें, अपडेट करें और हटाएँ।
• असाइनमेंट विकल्प। टूलसेट, प्लेबैक सीमा, अधिकतम अंक, Google Classroom विषय, विशिष्ट छात्रों को असाइन करना, लॉक किए गए टेम्पलेट, और LTI, Canvas तथा MusicFirst असाइनमेंट का विवरण।
• एडमिन किसी managed account का username, नाम और email संपादित कर सकते हैं; उपयोगकर्ता सूचियों को active license के आधार पर फ़िल्टर किया जा सकता है।
• पुराने सबमिशन पैरामीटर studentComment और returnFeedback को हटाकर उनकी जगह नई grading calls का उपयोग किया गया है।

• असाइनमेंट archive और unarchive करें, और किसी असाइनमेंट का मुख्य प्रकार पढ़ें (new score, template या shared writing)।
• संगठन के उपयोगकर्ता। पहले नाम और अंतिम नाम के साथ खाते बनाएं, उपयोगकर्ता सूचियों को sort और filter करें, किसी filter से मेल खाने वाले उपयोगकर्ताओं की गिनती करें, और समूह सदस्यों को उनके sync source (Google Classroom, Microsoft Teams, Clever) के आधार पर filter करें।
• Score details अब playback में उपयोग किए गए audio samples को सूचीबद्ध करते हैं, साथ ही एक normalized instrument list भी देते हैं जो अब samples पर निर्भर नहीं करती।

अपने कोड से मिक्स नियंत्रित करें, और कर्सर के नीचे क्या है इसे पढ़ें।

• वॉल्यूम और म्यूट: getMasterVolume, setMasterVolume, getPartVolume, setPartVolume, mutePart, unmutePart
• सोलो और रीवरब: setPartSoloMode, unsetPartSoloMode, getPartSoloMode, getPartReverb, setPartReverb
• जाँच: getMeasureDetails, getNoteDetails
• जोड़े गए इवेंट: noteDetails, measureDetails, cursorContext

• स्पेसिफ़िकेशन अब OpenAPI 3.0 पर चला गया है। पिछले संस्करण OpenAPI 2 (Swagger) में वर्णित थे।
• अब स्कोर में अरेंजर और उनके प्ले के आँकड़े उपलब्ध हैं; किसी आइटम को trash में पड़े रहने के बजाय जल्द चलने वाले deletion के लिए शेड्यूल किया जा सकता है।
• Flat for Education. असाइनमेंट अटैचमेंट अब Google Drive फ़ाइलें हो सकते हैं, क्लासों में उनके Microsoft Teams विवरण शामिल हैं, और education account अब पहला नाम और अंतिम नाम दिखाते हैं।

• मेटाडेटा में किए गए बदलाव अब एडिटर तक तुरंत पहुंचते हैं। API के ज़रिए किसी स्कोर का title, subtitle, composer, lyricist या license text अपडेट करने पर यह बदलाव खुले हुए editors तक रीयल-टाइम में पहुंचते हैं, और एक नया version सहेजा जाता है। Descriptions अब दोगुनी लंबी हो सकती हैं (2,000 characters).
• Education submissions अब अपनी state दिखाती हैं (created, turned in, returned); revision metadata अब आख़िरी modification event लौटाता है।
• समर्थित locales में अब Turkish भी शामिल है; public profiles अब बताते हैं कि कोई account Flat टीम का है या नहीं।

• getMIDI जोड़ा गया
• getMusicXML अब शीर्ष स्तर पर Uint8Array लौटाता है — रिस्पॉन्स में अब .data प्रॉपर्टी नहीं होती
• कर्सर का voiceIdx अब voiceIdxInStaff है

embed रिलीज़ के लिए अपडेट किया गया।

• SDK अब डिफ़ॉल्ट रूप से flat-embed.com से लोड होता है
• पुराना हो चुका edit action और edit event हटा दिया गया है
• setNoteColor हटा दिया गया है

• ज़्यादा इम्पोर्ट फ़ॉर्मैट। अब Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar और MuseScore फ़ाइलें इम्पोर्ट की जा सकती हैं, और इम्पोर्ट में फ़ाइलनाम भी स्वीकार किया जाता है।
• कलेक्शन को किसी parent collection के अंतर्गत सूचीबद्ध किया जा सकता है और उनकी creation date दिखाई जाती है; स्कोर उन कलेक्शन की सूची दिखाते हैं जिनसे वे संबंधित हैं।
• Contextual comments अब index के बजाय identifier के आधार पर किसी staff से anchor किए जाते हैं, और resource rights यह बताते हैं कि caller collaborator है या नहीं।

• Collections API. कलेक्शन बनाएं, उनकी सूची देखें, उन्हें अपडेट करें, हटाएं और पुनर्स्थापित करें, उनके स्कोर सूचीबद्ध करें, और स्कोर जोड़ें या हटाएं। इसके लिए read-only, add-only और full access के लिए तीन नए OAuth2 scope जोड़े गए हैं।
• स्कोर को trash से पुनर्स्थापित किया जा सकता है; admin rights के बिना किसी स्कोर को हटाने पर वह आपके खाते से केवल unshare होता है; किसी कॉपी को किसी विशेष collection में भेजा जा सकता है।
• टिप्पणियों को प्रकार के अनुसार फ़िल्टर किया जा सकता है (document या inline)।
• Part export अब index की जगह part identifier का उपयोग करते हैं, और सितंबर 2019 से किसी उपयोगकर्ता की score listing केवल public score ही लौटाती है।

• संगठन खाता प्रबंधन। एडमिन प्रबंधित खातों को अपडेट कर सकते हैं, उन्हें हटा सकते हैं या उन्हें उपभोक्ता खातों में बदल सकते हैं; उपयोगकर्ता और आमंत्रण सूचियाँ cursor-based pagination का उपयोग करती हैं।
• कक्षाओं में अब एक inactive स्थिति है जिसे फिर से active किया जा सकता है, और वे अपना Canvas LMS domain और Clever section बताती हैं; असाइनमेंट में अब एक draft स्थिति और exercise attachment type है।
• प्रोफ़ाइल अब एक theme और बजाए जाने वाले वाद्ययंत्र दिखाती हैं।

• एम्बेड को कीबोर्ड फ़ोकस देने के लिए focusScore मेथड जोड़ा गया
• एडिटर कॉन्फ़िगरेशन में नई defaultMode प्रॉपर्टी

• शिक्षा के लिए पहली API अब सार्वजनिक हैं। कक्षाओं, असाइनमेंट और सबमिशन, संगठन खातों और आमंत्रणों, LTI क्रेडेंशियल्स, तथा किसी संगठन के समूहों और उपयोगकर्ताओं का प्रबंधन करें: यानी स्कूल इंटीग्रेशन को जो कुछ चाहिए, सब कुछ।
• Scoped access. नए OAuth2 scopes कक्षाओं, असाइनमेंट और संगठन प्रशासन को कवर करते हैं, और हर एक का read-only विकल्प भी है, ताकि कोई इंटीग्रेशन सिर्फ़ वही माँगे जिसकी उसे ज़रूरत है।

अब आपका code यह देख सकता है कि embed किस तरह configure किया गया है और उसे editor में बदल सकता है।

• जोड़े गए methods: getEmbedConfig, setEditorConfig, edit
• जोड़ा गया event: edit

SDK अब MusicXML से स्कोर लोड कर सकता है और रीडर क्या कर रहा है, इसकी जानकारी दे सकता है।

• जोड़ी गई मेथड: getAutoZoom, setAutoZoom, loadMusicXML, getMusicXML
• जोड़े गए इवेंट: scoreLoaded, cursorPosition, rangeSelection, pause, stop, fullscreen, print
• इंटीग्रेशन टेस्ट जोड़े गए

Flat की REST API का पहला सार्वजनिक रिलीज़। अपने अकाउंट, स्कोर, उपयोगकर्ताओं और समूहों को अपने ऐप्स और स्क्रिप्ट्स से पढ़ें और प्रबंधित करें, और अन्य Flat उपयोगकर्ताओं की ओर से कार्य करने के लिए OAuth2 का उपयोग करें.

तब से हुए सभी बदलाव API changelog में दर्ज हैं, और developer documentation में authentication, reference और guides शामिल हैं।