想在编曲软件里试听
帮我把这份乐谱转成 MIDI。我想放进音乐软件里试听，再调整音符。文件准备好后，把下载链接给我。
下一步要试听、编辑音符或继续编曲，可以选择 MIDI。
Melogen / MCP
在 ChatGPT 中将乐谱转换为 MIDI
通过 OAuth 连接 Melogen，在 ChatGPT 或兼容的 MCP 客户端中附加乐谱，请 AI 返回 MIDI 或 MXL 文件。
查看 MCP 连接指南适用于支持 OAuth 和文件附件的 MCP 客户端。
PDF, PNG, JPGMIDI, MXL
先选一种适合你的乐谱处理方式
如果乐谱已经出现在 AI 对话里，MCP 连接可以让你在原来的对话中说明需要什么文件，由兼容客户端传递附件并获取任务结果。如果只是想上传一份文件完成转换，直接使用网页工具会更方便。
PDF, PNG, JPGMIDI, MXL
继续在 AI 对话中处理
适合希望把乐谱附件、输出要求和任务进展放在同一段对话中的用户。客户端需要能够调用转换工具、完成 OAuth 授权，并传递文件附件。
连接前，先确认这三件事
第一次发送乐谱前，检查客户端、账户和文件。能聊天，并不代表客户端具备执行这套流程的全部能力。
客户端支持所需的连接能力
ChatGPT 的连接选项取决于账户、工作区设置和可用的应用能力。其他 MCP 客户端也需要支持远程 MCP、OAuth 和文件附件。开始前，请先查看客户端提供的连接选项。
准备好你的 Melogen 账户
按照连接指南，通过 OAuth 授权账户。转换会使用 Melogen 账户及其可用积分；从对话中发起请求，也需要满足服务本身的账户要求。
把原始乐谱作为附件发送
附加包含乐谱的 PDF、PNG 或 JPG。尽量让页面清晰、方向正确，保留完整的谱表和页边。这些是输入准备建议，不代表每个音符都能被正确识别。
请在客户端内附加文件，不要用公开链接或 YouTube 链接替代附件。如果客户端不支持附件，可以使用网页转换工具。
从 ChatGPT 附件到 MIDI 文件
完成连接后，在对话中提交乐谱并获取结果。
将 Melogen 连接到客户端
按照 MCP 连接指南，在兼容客户端中通过 OAuth 授权你的 Melogen 账户。
附加乐谱并提出要求
附加 PDF、PNG 或 JPG 乐谱，说明需要 MIDI 或 MXL。AI 会使用客户端提供的文件描述符调用 start_sheet_music_conversion。
获取任务结果
AI 使用 get_sheet_music_conversion 查询任务。任务成功后，通过返回的链接下载输出文件。
像平常一样，说明你想怎么用这份谱子
不用自己写工具调用。附上乐谱，说清楚需要哪种文件，再由兼容客户端处理请求。下面是可以参考的表达方式，不是实际转换结果。
想继续修改乐谱
请把附件里的乐谱转成 MXL，我要放到记谱软件中继续修改。查一下任务进度，完成后把文件给我。
下一步主要是编辑乐谱，可以选择 MXL。
两种文件都留一份
这份谱子请同时输出 MIDI 和 MXL。继续查询同一个任务，成功后把两个文件的下载链接发给我。
既要在编曲软件里处理音符，又要在记谱软件里编辑谱面时，可以同时请求两种格式。
开发者参考：参数与完整 MCP 调用示例
客户端负责提供文件描述符。提交一次任务后，保留任务标识，再查询该任务的状态和产物。下方是请求与响应示例，不是正在执行的任务。
MCP: start_sheet_music_conversion + get_sheet_music_conversion
MCP 客户端将附件作为文件描述符传递。start_sheet_music_conversion 提交任务；get_sheet_music_conversion 查询任务状态并获取输出文件。
PDF, PNG, JPG MIDI, MXL
参数
file — 主机提供的文件描述符output_formats — 请求的输出格式，例如 ["midi", "mxl"]preprocess — 已附加乐谱的可选预处理
MCP / JSON
// MCP Tool Call (handled automatically by your AI agent)
{
"tool": "start_sheet_music_conversion",
"arguments": {
"file": {
"file_id": "host_uploaded_score_123",
"download_url": "https://host.example/files/score.pdf",
"file_name": "score.pdf",
"mime_type": "application/pdf"
},
"client_request_id": "chatgpt-score-0001",
"output_formats": ["midi", "mxl"]
}
}
// Poll until the job is complete
{
"tool": "get_sheet_music_conversion",
"arguments": {"task_id": "task_abc123456789"}
}
// Completed response (abridged)
{
"task_id": "task_abc123456789",
"status": "succeeded",
"artifacts": [
{"type": "midi", "file_name": "score.mid", "download_url": "https://..."},
{"type": "mxl", "file_name": "score.mxl", "download_url": "https://..."}
]
}选 MIDI 还是 MXL，取决于你接下来要做什么
两种文件都能表达音乐，但适合的后续工作不同。通过这项连接，可以请求其中一种，也可以同时获取两种。
MIDI：试听与音符编辑
MIDI 保存音符事件等演奏信息。导入兼容的音乐软件后，可以选择音色、试听序列，或者修改音符和时间位置。它不是录音文件，也不会保留原始纸面乐谱的视觉排版。
MXL：在记谱软件之间传递乐谱
MXL 是压缩的 MusicXML，用于交换数字乐谱。可以在兼容的记谱软件中打开，继续编辑。不同软件的导入结果和排版可能有所不同，打开后仍需检查。
下载完成后，和原谱对照一遍
正式编曲、排练或分发前，检查音符、节奏、声部和小节。保留原始附件作为对照：任务完成代表已经生成文件，并不代表所有音乐细节都经过核实。
连接或转换卡住时，从哪一步查起
先判断问题发生在哪个阶段。找不到连接、读不到附件和任务仍在处理，分别需要不同的处理方式。
客户端里找不到连接入口
确认客户端和账户允许使用所需的 MCP 能力，再按照 Melogen 连接指南操作。如果使用受管理的工作区，连接权限还可能取决于管理员设置。
工具无法读取附件
确认发送的是 PDF、PNG 或 JPG 附件，而不只是一条链接。可以在兼容客户端中重新附加原始文件。如果客户端无法传递附件，请使用在线转换器。
任务一直显示处理中
请客户端查询已有任务，而不是再次发起转换。反馈问题时保留任务标识。如果任务失败，先根据返回的信息检查账户或输入状态，再决定是否重新提交。
结果链接打不开了
请在链接有效时保存文件。如果链接过期或访问被拒绝，先查看任务返回的信息，必要时联系支持。不要仅为排查下载链接就重新发起一次转换。
ChatGPT 与 MCP 接入常见问题
了解 AI 客户端中的授权、附件传递与结果获取。
客户端需要支持 MCP 连接、OAuth 登录和文件附件。按照 Melogen MCP 连接指南授权账户；可用的连接选项取决于客户端和账户。
不需要。在兼容客户端中附加 PDF、PNG 或 JPG 乐谱即可。客户端会向工具提供文件描述符，你无需自行创建公开的文件链接。
start_sheet_music_conversion 返回任务标识，客户端通过 get_sheet_music_conversion 查询状态，在成功后获取输出链接。下载后请检查乐谱再使用。
可以。使用在线乐谱转 MIDI 工具，即可直接在网站上传并转换。本页介绍的是 ChatGPT 和兼容客户端使用的 MCP 接入流程。
不是。MCP 连接使用你的 Melogen 账户及其可用积分。请以服务显示的账户和任务信息为准；本页不承诺免费额度，也不承诺每份乐谱都有固定的转换费用。
先查询已有任务。客户端应使用返回的任务标识调用 get_sheet_music_conversion。再次发起请求可能创建另一项转换；查询进度或联系支持时，请保留原任务信息。
在 ChatGPT 中将乐谱转换为 MIDI
通过 OAuth 连接 Melogen，在 ChatGPT 或兼容的 MCP 客户端中附加乐谱，请 AI 返回 MIDI 或 MXL 文件。