从一段参考音频，找出旋律线索

准备 16 秒参考音频，得到 ABC 与 MIDI。把曲谱和原音频放在一起检查，学会分辨值得继续研究的乐句与需要修正的地方。

1. 选一段容易听清的素材

选你自己的短器乐片段，或已获许可的素材。为了方便检查，可以先挑主旋律清楚、背景不拥挤的一段；这是输入选择建议，不是转谱准确率保证。

当前真实路径只验证并接受恰好 16 秒、PCM16 WAV：24 kHz 单声道，或 48 kHz 双声道。用你现有的音频工具导出其中一种格式，保留原文件。可以在原音频中记下一个明显的音高变化或节奏，稍后用来检查。

上传允许的 64 MiB / 600 秒是存储预算，不能推断这些长度都能转谱。这个操作不会识别歌词，也不会自动生成 Cover。

2. 上传到项目，再转谱一次

继续使用 Morning song Project，把文件作为 Reference Audio 上传。打开正式 Web 的“参考转谱”，选择这份原文件，检查准备状态，再选择“开始转谱”。完成后查看乐谱并下载 ABC/MIDI；原参考音频保持不变。完整步骤见工作区转谱指南。需要 API 操作时再展开下面的补充；文档页面不会上传文件。

当前操作入口：本地 Swagger 的完整路径

1. 打开已运行应用 API 的 http://127.0.0.1:8000/docs。生成环境应使用已就绪的真实 Runtime；fake 模式只返回标识的测试结果。
2. 已有 Project 用原 id；若从本章开始，用 POST /projects 输入 {"name":"Morning song"}，记录返回的 id。
3. 在 POST /projects/{project_id}/assets 填入 Project id，用 file 选择上面的 WAV。提交后记录响应中的 Asset id。
4. 在 POST /projects/{project_id}/transcriptions 使用下面的 JSON，替换占位值。提交一次并记录响应中的 Job id。
5. 用 GET /projects/{project_id}/jobs/{job_id} 读取同一个 Job，直到 completed 或明确失败。completed 的 result 给出 score_id、abc_asset_id 和 midi_asset_id。
6. 用 GET /projects/{project_id}/scores/{score_id} 读取曲谱信息，再用 GET /projects/{project_id}/assets/{asset_id}/content 分别下载 ABC 和 MIDI。保存到自己的 Morning song 文件夹。

{
  "reference_asset_id": "<REFERENCE_ASSET_ID>"
}

3. 对照听，而不只看文件是否存在

1. 先播放原参考音频，重新听你记下的那个乐句。
2. 打开 ABC 文本，或用自己的 ABC 阅读工具看小节、节拍与音高。MIDI 可在你现有的 MIDI 播放器或音乐软件中打开。
3. 对照原音频检查旋律走向和节奏。有偏差就记录发生在哪个乐句，不把能下载的曲谱当作完全准确的抄谱。

应用会检查完整文件并导入 Score，但这些检查不能证明任意音乐的转谱准确性。可以在内置编辑器中修正音符、试听并独立保存，再在正式 Web 重新生成；也可尝试melody/full Cover，保留可检查的参考来源。

如果格式被拒绝，修正导出设置

422 reference_profile_unsupported 表示音频形状不在当前范围。检查是否为恰好 16 秒、16 bit 整数 PCM WAV，以及支持的声道与采样率。只改文件扩展名不能修正编码；重新导出支持的文件，再上传为新的 Reference Audio。

若提交回执不确定或等待断开，先查询已知 Job。不要通过反复上传或提交来找回结果。completed 时直接下载同一结果；明确 failed 时保留错误并按 recovery 指引处理。

下一种玩法：把参考变成观察题

记下原片段的一个特征：节奏更稀疏、旋律更连贯，或某个乐句的起伏。检查、保存并选定这份 Score，再用melody/full Cover只换新风格，判断伴奏如何变化。

继续尝试风格与歌词变化 →

源码版本: 1ce3268正文来源: docs/learn/reference.md