更新日誌

開發者儀表板已按你的整合功能重新設計。每項功能（Embed、OMR、REST API、Import API、LTI）現在都有一張卡片，顯示其範圍、收費和文件，而你的應用程式已在使用的功能會排在前面。

• 新增帳戶層級的 OMR 區段，將你的工作、額度及其記錄集中在同一處，因為 OMR 額度由你所有應用程式共用。
• 寫程式碼前先試用 OMR。 playground 可接收 PDF 或相片，顯示頁數、每頁費用，以及執行後會剩下多少餘額；待你確認後才會執行工作。輸出只會提供 MusicXML 下載，不會存入你的資料庫。
• 更清晰的應用程式頁面。 個人 token、OAuth2 憑證和 OMR 存取權會按應用程式分組，並清楚標示帶有 OMR scope 的憑證。

可從 flat.io/developers 開啟。

我們的 REST API 規格已遷移至 OpenAPI 3.1，OMR API 結束測試期，而 Flat for Education 的作業功能也不再只限於列出與建立。

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

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

• 可離線使用。 無需連線即可編寫、編輯和播放樂譜；重新連線後，你的變更便會同步。
• 你的樂譜在每部裝置上都可存取。 使用 Flat Power 時，你在桌面版看到的資料庫，與你在網頁版、iPhone、iPad 和 Android 上開啟的是同一個。
• 透過 USB 和藍牙進行 MIDI 輸入。 連接鍵盤即可彈奏輸入音符。
• 可開啟你的檔案。 在 Finder 或 Explorer 中雙擊樂譜，便會在應用程式中開啟，而不是在瀏覽器分頁中開啟。
• 支援使用 Apple 登入 macOS，同時保留你原有的登入選項。
• 自動保持最新。 新版本會自行安裝。

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

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

• 三種開始循環的方法：選取小節後按 L、在選取選單中選擇「循環」，或按頂部欄中的循環按鈕，將游標所在的小節設為循環。你亦可拖曳控制柄來擴大或縮小範圍，即使在播放期間也可以操作。
• 音符仍可編輯。 在播放時按一下某個音符並加以修改，下一輪便能聽到效果。循環亦可配合同步的 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 作業現在可以透過 API 進行設定。
• 來自上游供應商的錯誤（例如 Google Classroom）現在會附帶該供應商自己的本地化訊息。

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

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

• 現已支援帶有共用休止符和隱形休止符的多聲部段落。
• 小節線和反覆結尾括號（volta）現在可在小節內正確放置。
• 連桁的辨識現在更可靠。
• 現在可以辨識如管弦樂總譜那樣跨越多個譜表書寫的拍號。
• 修正了部分和弦符號匯出到 MusicXML 時使用非標準和弦類型的問題。

在網頁版應用程式中，從 PDF 或相片匯入樂譜現已採用全新流程，基於 Flat 自家的辨識引擎。這會為所有使用者取代先前的 PDF 匯入方式。

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

Flat 已提供此功能；對教師和管理員而言，也可在 Flat for Education 中使用。這個新流程將於未來幾週內登陸 iOS 應用程式。

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 自研的 PDF 和相片匯入 AI 模型。這個模型由我們內部設計及訓練，用來取代產品推出時使用的第三方引擎。掌握端到端的技術能力，讓我們可以進一步提升準確度、擴大可辨識的記譜內容、更快推出改進，並讓結果更貼合 Flat 自家的樂譜格式，令匯入內容能更自然地融入產品的其他部分。即使是這個首個版本，已經能讀取你樂譜中更多內容：

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

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

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

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

這是自 2024 年以來最大的一次規格更新，讓 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 的支援行列，樂譜亦可匯出為原生 .flat 檔案。
• 虛擬集合。 All scores、collaborations 與 likes 取代了資料庫中舊有的資料夾階層，與重新設計的 Flat 資料庫一致。
• Flat for Education。 支援附有音訊或影片錄製的演奏作業，以及 backing track、metronome 和 speed 選項；用於共同寫作的小組提交；富文字指示；學生子分組；可排程並針對個別學生指派的 Microsoft Teams 作業；資源庫中的詳細描述與作業類型。
• 統一的 LTI 設定，適用於 LTI 1.1 和 1.3，並包括動態註冊。先前的 LTI 1.1 憑證呼叫已棄用。
• 新增樂譜年度統計、個人檔案中的公開樂譜數量，並移除少數已棄用很久的欄位。