變更記錄

開發者儀表板已依照你的整合可執行的功能重新打造。每項功能（Embed、OMR、REST API、Import API、LTI）都有一張卡片，顯示其範圍、定價與文件，而你的應用程式已在使用的功能會優先顯示。

• 帳戶層級新增 OMR 區塊，可在同一處查看你的工作、點數及其歷程，因為 OMR 點數是由你所有應用程式共用。
• 寫程式前先試用 OMR。 測試沙盒可接受 PDF 或照片，顯示頁數、每頁費用，以及執行後剩餘的點數餘額，待你確認後再執行工作。輸出會提供為 MusicXML 下載，不會存入你的資料庫。
• 更清楚的應用程式頁面。 Personal tokens、OAuth2 憑證與 OMR 存取權限會依應用程式分組顯示，並特別標示具備 OMR scope 的憑證。

可從 flat.io/developers 開啟。

我們的 REST API 規格升級到 OpenAPI 3.1，OMR API 結束 beta 階段，Flat for Education 的作業功能也不再只限於列出與建立。

• OMR API 已穩定。 端點、欄位與行為在任何破壞性變更前，現在都會遵循我們一貫的淘汰程序。新的 FAQ 說明了點數與計費、限制與處理時間、辨識品質與語言，以及商業用途與隱私。
• 在 Flat for Education 中可讀取、更新與刪除作業。刪除作業也會一併移除其提交內容與學生的副本；若要保留作業內容，請改為封存。
• 點數分類帳。 新增呼叫可列出你的點數歷史；餘額仍保留在 OMR capabilities 呼叫中。
• 支援匯入 Finale 檔案（.musx），以 best-effort 為原則，且建立樂譜時也已記錄掃描樂譜匯入（PDF 與圖片）的相關說明。
• OpenAPI 3.1。 可為 null 的欄位現在使用 3.1 語法；工具若固定使用 OpenAPI 3.0，則需要更新。OMR 檔案上傳中的 mimeType 欄位已移除。

Flat 現在推出 macOS 和 Windows 桌面應用程式：完整編輯器可在獨立視窗中使用，免費下載，且你的資料庫會在桌面、網頁與行動裝置之間保持同步。

• 可離線使用。 無需連線也能撰寫、編輯與播放樂譜；重新連上網路後，你的變更就會同步。
• 你的樂譜遍佈每台裝置。 使用 Flat Power 時，你在桌面版看到的資料庫，和你在網頁、iPhone、iPad 與 Android 上開啟的是同一份。
• 透過 USB 與 Bluetooth 進行 MIDI 輸入。 接上鍵盤即可直接彈奏輸入音符。
• 可開啟你的檔案。 在 Finder 或 Explorer 中按兩下樂譜檔案，會直接在應用程式中開啟，而不是在瀏覽器分頁中開啟。
• 在 macOS 上使用 Apple 登入，與你原本已有的登入選項並列。
• 自動保持最新。 新版本會自行安裝。

可免費下載；只有在同步時才需要 Flat 帳號。請前往 flat.io/desktop。

選取一段樂句後，按下 L，它就會重複播放，直到你叫它停止；同時音符仍可編輯，因此每次修改都會在下一輪播放時立即呈現。循環模式在所有方案中皆可免費使用。

• 三種開始循環的方式：選取小節後按 L、從選取選單中選擇「Loop」，或按下頁首中的循環按鈕，循環播放游標所在的小節。你也可以拖曳控制把手來擴大或縮小範圍，甚至在播放時也可以調整。
• 音符仍可編輯。 在播放時點擊音符並加以修改，下一輪就能聽到結果。循環也可搭配已同步的 YouTube、Vimeo、SoundCloud 或上傳的錄音使用。
• 播放會從游標位置開始，而不是從最前面開始。停止播放後會保留位置：按 Space 會從游標開始播放，按 Shift + Space 則會從音樂停止的確切位置繼續播放（在行動裝置上請長按 Play）。回到開頭時，若目前為停止狀態，會移動游標；若正在播放，則會重新開始播放。

此功能已在網頁版的新編輯器，以及 Android 上新的行動工具列中提供；iOS 即將跟進。嵌入式樂譜也可透過 embed API 使用循環功能。

我們的自研模型推出了新版本，現在所有 PDF 與照片匯入都由它處理，這次特別針對頁面上連音的印刷方式進行了優化。

• 現在支援隱含連音。 排譜者通常只會在一個樂句中的第一個三連音或六連音上方標示小小的「3」或「6」，後續的音群則不再重複標示——演奏者會被預期延續這個模式。這些沒有標記的音群就是隱含連音：實際上要按連音演奏，但譜面上沒有任何標示。這種寫法在 19 世紀的版本、練習曲與變奏曲中非常常見。現在掃描功能會根據小節的節奏還原這些連音，而不再為了配合拍號而刪除音符。
• 憑空誤判的連音更少了。 先前模型有時會把一般的符槓音群誤標成三連音，即使上方根本沒有印出數字，這些數字也會出現在你的樂譜中。現在只有在頁面上確實畫出連音標示時，才會寫入連音。

• 由你控制資料保留期限。 OMR 工作現在會告訴你其檔案會保留多久（預設為 30 天），每個 MusicXML 工作都會附帶其到期日，而且你可以在收集完成後立即刪除工作檔案與結果。
• 登入前即可偵測功能。 OMR capabilities 呼叫現在無須帳號即可使用，並會列出支援的辨識語言及其名稱。
• ABC 記譜匯出 現已支援任何樂譜修訂版本，與 MusicXML、MIDI 和其他格式並列。和 MIDI 一樣，它不包含完整的排版資訊。
• 在 Flat for Education 中，Free Record assignments 現在可透過 API 進行設定。
• 來自上游提供者（例如 Google Classroom）的錯誤，現在會附帶該提供者自己的本地化訊息。

我們自研模型的新版本現已用於所有 PDF 與照片匯入，在掃描樂譜基準測試中，錯誤率降低了 22% 到 51%。提升在較困難的頁面上最為明顯，例如較舊的雕版印刷與印刷不均的樂譜。

改良版的 Flat 自研模型現已用於所有 PDF 和照片匯入，尤其包括：

• 現已支援帶有共用休止符與隱形休止符的多聲部段落。
• 小節線與反覆結尾（voltas）現在會正確放置在小節內。
• 連桿的辨識現在更可靠。
• 現已可辨識跨越多個譜表繪製的拍號，例如管弦樂總譜中的拍號。
• 修正了部分和弦符號匯出為 MusicXML 時使用非標準和弦類型的問題。

在網頁版 App 中，從 PDF 或照片匯入樂譜現在採用全新流程，並使用 Flat 自家的辨識引擎。這個新流程已全面取代先前的 PDF 匯入功能。

• 選擇你要的頁面。 上傳 PDF 或多張照片後，只保留包含樂譜的頁面。你保留的每一頁都會使用 1 個點數。
• 在辨識進行時追蹤進度。 進度列會逐頁顯示掃描進度，而在處理期間你也可以繼續使用 Flat。
• 在建立樂譜前先檢查。 當辨識引擎無法確定某個樂器時，它會請你確認標題與偵測到的樂器，並在每個項目旁顯示頁面上印出的聲部名稱。若所有樂器都能確定，這個步驟會自動略過。

Flat 已提供這項功能；對教師與管理員而言，Flat for Education 也同樣提供。iOS App 將在接下來幾週內加入這個新流程。

Flat 的 OMR 引擎現在可透過開發者 API以程式方式使用。你可以傳送 PDF 或照片、追蹤辨識進度、檢視偵測到的樂器，然後將結果匯入 Flat 資料庫作為可編輯的樂譜，或匯出為 MusicXML 或 MIDI。這與編輯器中 PDF 與照片匯入所使用的是同一套內部模型，現在也能大規模用於你自己的應用程式與工作流程。

專用的 OMR API（v2.24.0）是建立在 v2.23.0 新增至樂譜建立流程的背景 PDF 匯入功能之上：匯入檔案時可要求任務支援，並輪詢該任務直到樂譜準備完成。兩個版本的詳細內容，請參閱 API 變更日誌。

我們改進了掃描時讀取頁面版面的方式。現在匯入 PDF 和照片時，產生的樂譜會更乾淨、更準確，尤其是在複雜版面上：

• 現在能正確分開密集頁面。 由許多短系統上下密集排列的頁面，不再被合併在一起；每個系統都會分別偵測。
• 更適合管弦樂總譜與大型合奏譜。 像鋼琴與管風琴這類多譜表樂器，以及含有許多譜表的大型樂譜，現在都能更可靠地辨識。
• 支援寬幅、橫向與小冊子版面。 橫向頁面不再裁掉左側邊緣（避免譜號被截斷），多頁與小冊子掃描也能正確處理。
• 減少雜訊誤判。 頁尾與頁邊附近的無關元素，不再被誤判為音樂內容。

現在，所有 PDF 和照片匯入都會由 Flat 自家開發的模型處理。這次發佈是以轉譜精準度為重點的重大新版本：在所有測試集中，樂譜辨識的正確性（決定樂譜是否正確的音符、節奏、連結線與臨時記號）都有提升，其中進步最明顯的是：

• 力度記號： +39%
• 延長記號、演奏記號、連結線、臨時記號： +30 to 37%
• 音符時值： +22%
• 圓滑線、附點音符、休止符、譜表與聲部分配： +14 to 20%

文字、力度記號與版面位置也更加精確：歌詞、和弦名稱與力度記號能更可靠地附加到正確的音符上，即使是在鋼琴大譜表或包含譜號變更的聲部等複雜版面中也是如此。

我們正逐步推出 Flat 自家的 AI 模型，用於 PDF 和照片匯入。這個模型由我們內部設計與訓練，將取代產品推出時使用的第三方引擎。從頭到尾掌握這項技術，讓我們能進一步提升辨識準確度、擴大可辨識的內容、更快推出改進，並讓結果更貼合 Flat 自有的記譜格式，使匯入內容能更自然地融入產品的其他功能。這個第一版已經能讀取你更多的樂譜內容：

更廣的記譜涵蓋範圍。 新增可辨識項目：

• 和弦記號，會依其音樂意義正確編碼為可編輯的和弦，而不只是一般文字
• 小節反覆記號與節奏斜線
• 速度與節拍器標記（含 BPM）

更多語言的歌詞與文字。 預設可辨識以拉丁字母書寫的語言中的歌詞、排練記號及其他文字，另外也支援日文、韓文與中文。

更忠於原始版面。 現在匯入結果會更貼近來源樂譜的版面配置，包括每行的小節數、每頁的樂系數，以及整體結構。這對大型、複雜的樂譜，例如管弦樂作品，以及像鋼琴這類多譜表樂器的樂譜，會帶來明顯差異。現在也支援更多頁面格式，包括先前不支援的橫向頁面。

自 2024 年以來最大的一次規格更新，讓 API 跟上過去兩年的產品變更。

• 支援從 15+ 種格式匯入。 Guitar Pro、MuseScore、ABC 記譜、PowerTab、Capella、MEI、Overture、TablEdit、Band-in-a-Box、Karaoke MIDI、MuseData、Score Writer、Bagpipe Music Writer 和 Encore 現已加入 MusicXML 與 MIDI 的行列，樂譜也可匯出為原生 .flat 檔案。
• 虛擬收藏。 所有樂譜、協作內容與按讚項目將取代資料庫中舊有的資料夾階層，與重新設計的 Flat 資料庫保持一致。
• Flat for Education。 支援含音訊或視訊錄製的演奏作業，以及伴奏音軌、節拍器與速度選項；支援共同創作的小組繳交；支援富文字說明；學生子群組；可排程並指定給個別對象的 Microsoft Teams 作業；以及資源庫中的豐富描述與作業類型。
• 統一的 LTI 設定，適用於 LTI 1.1 與 1.3，包含動態註冊。先前的 LTI 1.1 憑證呼叫已棄用。
• 新增樂譜年度統計、個人檔案上的公開樂譜數量，並移除少數已長期棄用的欄位。