更新日志

开发者控制台已围绕你的集成能力重新设计。每项能力（Embed、OMR、REST API、Import API、LTI）现在都有一张卡片，显示其作用范围、价格和文档，而你的应用已在使用的能力会排在前面。

• 新增账户级 OMR 部分，将你的任务、额度及其历史记录集中在一处，因为 OMR 额度由你的所有应用共享。
• 写代码前先试用 OMR。 playground 可接收 PDF 或照片，显示页数、每页费用以及执行后剩余的余额；确认后才会运行任务。输出仅提供 MusicXML 下载，不会进入你的资料库。
• 更清晰的应用页面。 个人令牌、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 或资源管理器中双击乐谱，即可在应用中打开，而不是在浏览器标签页中打开。
• 支持使用 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 凭据调用已弃用。
• 新增乐谱年度统计、个人资料中的公开乐谱数量，并移除了少量早已弃用的字段。