GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

Suno MIDI 导入与导出:要求与 API 指南

Suno MIDI 导入与导出指南:V6_WILD 文件要求、6 秒最小时长、分轨转 MIDI JSON 的 API 工作流,以及当前按次请求费率。

Suno MIDI 导入与导出:要求与 API 指南

Suno MIDI 现已支持双向操作,而两个方向的技术规则并不相同。2026 年 11 月 4 日,Suno 在 Create 页面中直接加入了 MIDI 文件上传功能,让 Pro 和 Premier 订阅用户可以从 .mid 或 .midi 文件起步创作 V6 歌曲,而不再仅依赖文本提示词[1]。反过来,要把 AI 生成的曲目重新转成可编辑的音符,仍需先做分轨(stem separation),无论是在 Suno Studio 中点击 Get MIDI[2],还是通过 Suno MIDI API 串联两个接口[4]。

大多数文章会把 Suno MIDI 当成一个单一的导出按钮,或停留在泛泛的 DAW 混音建议上。如果你在开发音频工具,或在 DAW 与 Suno 之间反复导轨做小样,真正的阻力往往藏在约束条件里:Suno MIDI 导入运行在哪个模型版本上、语法完全有效的 .mid 文件为何会在渲染前被拒、API 提取为何返回音符 JSON 而非二进制 .mid 下载文件,以及每一步的费用是多少。以下内容将 Suno 当前文档与我们在 2026 年 11 月 19 日完成的线上实测 API 调用结果一一对应。

两种 Suno MIDI 工作流及其适用场景

在编写集成代码或为 Studio 按月付费之前,先区分这两个方向。Suno MIDI 导入能把无声的音符序列变成完整编曲,在做早期 demo 时可快速替代加载数 GB 采样音源库。Suno MIDI 导出则方向相反,从分离后的分轨中恢复音高、时值与力度数据,便于你在 Logic、Ableton、FL Studio 或 MuseScore 中更换合成器音色、核对和弦声部排列或重建声部。

工作流细节Suno 网页应用 / Studio(界面)reAPI HTTP API(/api/v1/audio/generations)
从 MIDI 启动歌曲创作将 .mid / .midi 拖入 Create(Simple 模式、v6-wild、Pro/Premier 套餐)[1]model: "suno-music"、custom_mode: false、version: "V6_WILD"、midi_urls(1 个公开 URL)[4]
实时钢琴卷帘与 USB 控制器Studio 中的原生 MIDI 轨道,支持 Web MIDI API(Chrome;Safari 不支持 Web MIDI)[3]不适用(无状态 REST 任务流水线)
从歌曲中提取 MIDI先在 Studio 中提取分轨,再右键点击某一分轨并选择 Get MIDI(10 个 Suno 积分)[2]第 1 步:suno-vocal-separation(已生成曲目或外部 audio_url)。第 2 步:针对分轨的 task_id 调用 suno-midi[4]
导出的 MIDI 格式标准 .mid 文件下载[2]结构化 JSON(instruments[].notes[],含 pitch、start、end、velocity)[4]
计费模式(2026 年 11 月 19 日核查)订阅档位(Pro / Premier)+ Suno 积分余额[1][2]reAPI Suno 固定按次计费:音乐生成 US$0.06、分轨 US$0.05 至 US$0.25、MIDI 提取 US$0.001[5]

如果你想接上 USB 键盘实时即兴演奏、在浏览器钢琴卷帘中量化音符,或在音频时间线上拼轨选条,Suno Studio 是合适的环境。Safari 目前不支持 Web MIDI,因此 Suno 建议在 Studio 中搭配硬件控制器时使用 Google Chrome[3]。如果你需要批处理、应用集成,或按次付费而无需按月订阅席位,Suno MIDI API 会更便于自动化。

Suno MIDI 要求及通过 API 导入 .mid 文件

标准 MIDI 文件(Standard MIDI File)本身不包含声音。正如 Suno 在 2026 年 11 月 4 日的公告中所述,一个 .mid 或 .midi 文件最多可保存 16 个通道的音高与时间事件,每个通道最多包含 120 条控制器通道,用于延音、音量和调制等参数[1]。把该文件输入 Suno 后,模型能获得精确的音符时值与和声进行,而提示词决定生成结果对原谱的贴合程度:你可以让它用弦乐四重奏原样演奏你的和弦,也可以借用一段简短动机并将其发展成新的曲风[1]。

上线之初,Suno MIDI 导入以 Simple(灵感)模式运行在 V6_WILD 上[1]。在 reAPI 上,这对应 model: "suno-music",配合 custom_mode: false、version: "V6_WILD",以及包含一个公开 HTTP(S) URL 的 midi_urls[4]。如果在传入 midi_urls 时指定了其他版本,上游会将执行切换至 V6_WILD[4]。全平台均拒绝 Base64 和 data: URI,因此在调用生成接口前,需先把 .mid 文件托管到公开对象存储中(或通过 playground 的 suno-midi 上传器上传)[4]。

精确的文件与请求体限制

每次 Suno MIDI 导入请求在模型渲染音频之前,都必须满足五项 Suno MIDI 要求:

  • 格式:以 MThd 文件头开头的标准 .mid 或 .midi 二进制文件[4]。
  • 文件大小:最大 256 KB[4]。
  • 文件数量:每次请求 1 个 MIDI URL(midi_urls 最多接受一条记录),且参考附件总数(style、lyrics、image_urls、audio_urls、video_urls 和 midi_urls)不得超过 10 个[4]。
  • 模式:仅限灵感模式(custom_mode: false)。你可以将 midi_urls 与描述性 prompt(最多 3,000 个字符)组合使用,或在存在其他非自定义输入时省略 prompt[4]。
  • 时长:音乐时间线至少 6 秒,已在我们 2026 年 11 月 19 日的线上实测中验证[4]。

可运行的 Suno MIDI API 歌曲生成请求

curl -X POST https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "custom_mode": false,
    "instrumental": true,
    "version": "V6_WILD",
    "prompt": "Warm ambient electric piano and soft synth pad following the MIDI progression",
    "midi_urls": ["https://your-storage.example.com/original-progression-12s.mid"]
  }'

该接口会立即返回一个任务 ID。轮询 GET /api/v1/tasks/{id},直到 status 变为 "completed" 或 "failed"[4]。一次完成的 Suno MIDI 生成会在 output.audio_urls[] 中返回两个音频变体,并在 output.tracks[] 中返回两条按索引对齐的元数据记录,每条都带有可复用的 id、url、title 和 duration[4]。

我们在实测 MIDI 上传中遇到的真实失败情况

单看文档很少能弄清为什么一个有效的 .mid 文件会被驳回。2026 年 11 月 19 日,我们在真实付费生成任务上对 Suno MIDI 导入进行端到端测试时,立刻暴露出两种现实中的失败情况:

  1. 短于 6 秒的片段会被拒绝。 第一次测试上传了一个有效的 58 字节 Format 0 MIDI 文件,包含 120 BPM 下的四个四分音符(总计 2 秒)。任务失败并报错 "Your MIDI file is too short for us to check. Minimum duration is 6 seconds",预扣积分已退还(usage.credits: 0)。提交前请先将短乐句补足到至少 6 秒。
  2. 教科书式音阶可能触发已知录音匹配。 第二次测试将文件延长到 10 秒,内容为一段普通的 C 大调上下行音阶。尽管文件是全新合成的 MIDI 字节,任务仍失败并报错 "Our system matched this upload to a known recording"(同样退还为 0 积分)。r/SunoAI 上的制作人也报告过在裸旋律和标准练习曲上出现类似误判。
  3. 原创复调进行可顺利通过。 将音阶换成一段 12 秒、461 字节、100 BPM 的原创 D 利底亚和弦与旋律进行后,任务在 54.2 秒内完成,并返回了两个可播放的 MP3 变体(reAPI CDN 上为 HTTP 200)。

如果你围绕 Suno MIDI 上传构建自动化流水线,请尽早拦截这两种失败模式:调用 API 前先在客户端本地检查 MIDI 时长(拦截所有短于 6 秒的文件),并提醒用户,裸音阶或可辨识的翻唱旋律可能会触发指纹拒收。

从歌曲和分轨导出 Suno MIDI

从音频还原回音符始终是一个两阶段工作。无论是 Suno Studio 还是 Suno MIDI API,都不会一步把密集的立体声母带直接转写为 MIDI。

在 Suno Studio 中,你需要先通过 Stems 面板拆分片段,以分离人声、鼓、贝斯或其他层次。得到单独的 Suno MIDI 分轨后,点击目标分轨并在右键菜单中选择 Get MIDI。Studio 会扣除 10 个 Suno 积分,并输出一个可直接拖入 DAW 的标准 MIDI 文件[2]。

通过 reAPI HTTP 接口执行时,流程与 Studio 的设计相对应,但有一项实用优势:你不必先在 Suno 上生成源曲目。

第 1 步:使用 suno-vocal-separation 分离分轨

suno-vocal-separation 支持两种互斥的输入形式[4]:

  • 在 reAPI 上已生成的现有曲目: 传入 task_id(已完成的 reAPI task_... ID)和 audio_id(output.tracks[] 中某一条记录的 id)。
  • 你自己上传的音频: 仅传入 audio_url(公开 HTTP(S) URL,最大 20 MB;无需 audio_id)。为保持向后兼容,仍在传入 audio_url 时附带 audio_id 的旧版调用方依然会被接受[4]。

请谨慎选择分轨 type,因为它同时影响费用以及下游 Suno MIDI 导出的准确度:

  • separate_vocal(默认,US$0.05 / 50 积分):拆分为 2 条分轨(Vocals 和 Instrumental)[4][5]。
  • split_stem_advanced(US$0.10 / 100 积分):通过 stem_name 单独分离某一种乐器(支持 98 种乐器,例如 Piano、Bass、Electric Guitar、Drum Kit 或 Lead Vocal)[4][5]。
  • split_stem(US$0.25 / 250 积分):一次最多拆分为 12 条分轨[4][5]。
curl -X POST https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-vocal-separation",
    "audio_url": "https://your-storage.example.com/mix.mp3",
    "type": "separate_vocal"
  }'

当 GET /api/v1/tasks/{sep_task_id} 完成后,output.tracks[] 会返回每条分离出的分轨及其 label(如 Vocals 或 Instrumental)和各自的轨道 id[4]。

第 2 步:使用 suno-midi 转写分离后的分轨

接着,提交 model: "suno-midi",并将 task_id 设为人声分离任务 ID,而不是最初的 suno-music 任务 ID[4]。直接传入普通的音乐生成任务 ID 会被拒绝。带上分轨任务 output.tracks[].id 中的 audio_id 可只转写一条分轨;省略 audio_id 则会转写全部分离出的分轨[4]。

curl -X POST https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-midi",
    "task_id": "task_YOUR_SEPARATION_TASK_ID",
    "audio_id": "STEM_TRACK_ID_FROM_SEPARATION"
  }'

与 Studio 下载 .mid 文件不同,Suno MIDI API 会在 output.result.midi 中返回结构化音符数据[4]:

{
  "output": {
    "result": {
      "midi": {
        "state": "completed",
        "instruments": [
          {
            "name": "Electric Bass (finger)",
            "notes": [
              { "pitch": 45, "start": 1.24, "end": 1.72, "velocity": 0.78 }
            ]
          }
        ]
      }
    }
  }
}

每条音符记录包含标准 MIDI pitch(0–127)、以秒为单位的 start 和 end 时间,以及归一化 velocity(0–1)[4]。如果你的下游工具需要二进制 .mid 文件而非 JSON,在 Node.js 中用 @tonejs/midi 转换 output.result.midi 只需几行代码:

import { writeFileSync } from 'node:fs';
import { Midi } from '@tonejs/midi';

function saveSunoMidiJson(midiResult, outPath) {
  const midi = new Midi();
  for (const inst of midiResult.instruments ?? []) {
    const track = midi.addTrack();
    track.name = inst.name;
    for (const n of inst.notes ?? []) {
      track.addNote({
        midi: n.pitch,
        time: n.start,
        duration: Math.max(0.02, n.end - n.start),
        velocity: n.velocity,
      });
    }
  }
  writeFileSync(outPath, Buffer.from(midi.toArray()));
}

对 Suno MIDI 导出质量的合理预期

在 r/SunoAI 上,尝试将 Suno MIDI 导出结果直接导入 MuseScore 等打谱软件的制作人,经常反馈出现杂散鬼音、节奏抖动或复调串音。这类批评源于两个技术现实:

  1. 音频转 MIDI 会继承分轨串音。 分轨中残留的任何混响尾音或重叠和弦层,在音高检测时都会变成多余的短音符。在调用 suno-midi 之前,针对某一种清晰乐器(如 Piano 或 Bass)运行 split_stem_advanced,或使用 separate_vocal,通常会比直接转写密集的完整混音得到更干净的音符数组。
  2. 12 轨 split_stem 可能返回空音符数据。 如 reAPI Suno 参考文档所述,使用 type: "split_stem" 生成的分轨在稀疏或噪点较多的轨上可能完全检测不到任何音符[4]。如果转写后没有保留下任何音符数据,reAPI 会将该 suno-midi 任务标记为失败并退还积分,而不是返回空结果[4]。

应把提取出的 Suno MIDI 当作 DAW 中可编辑的和声与节奏草稿,而不是可直接打印的乐谱。先做量化(在 Studio 中按 Shift+Q,或使用你的 DAW 网格),清理短于 50 ms 的低力度杂音,再分配你自己的虚拟乐器。

整条流水线的价格与字符限制

reAPI 对 Suno 请求采用按操作固定费率计费,不随音频时长或模型版本变化(V6、V6_MINI 和 V6_WILD 价格相同)。失败和被拒绝的任务会自动退款。以下费率于 2026 年 11 月 19 日在 /models/suno 核验;最新价格请查看线上 Suno 模型页 或 Suno V6 页面[5]。

Suno MIDI 流水线步骤reAPI model + 选项费率(USD,2026 年 11 月 19 日核查)[5]积分(1 积分 = US$0.001)[5]
从 MIDI 生成歌曲(2 条音轨)suno-music(V6_WILD + midi_urls)US$0.06[5]60
分离人声 + 伴奏suno-vocal-separation(separate_vocal)US$0.05[5]50
从 98 种乐器中分离 1 种suno-vocal-separation(split_stem_advanced)US$0.10[5]100
最多拆分为 12 条分轨suno-vocal-separation(split_stem)US$0.25[5]250
从分轨提取 MIDI 音符 JSONsuno-midiUS$0.001[5]1

按上述 2026 年 11 月 19 日的费率计算,一次完整的 Suno MIDI 往返流程(以 US$0.06 从 MIDI 生成曲目、以 US$0.05 分离人声与伴奏、再以 US$0.001 转写 MIDI JSON)合计 US$0.111(111 积分)[5]。如果你自带音频文件,仅通过 split_stem_advanced(US$0.10)加 suno-midi(US$0.001)提取分离后的钢琴音符,这两次调用工作流合计 US$0.101(101 积分)[5]。

由于开发者在将提示词与 Suno MIDI 请求组合使用时也会遇到文本校验错误,以下列出 suno-music 上精确的 V6 字符限制[4]:

  • prompt:灵感模式(custom_mode: false,即 midi_urls 所要求的模式)下最多 3,000 个字符;在 V6 模型的自定义模式(custom_mode: true)下最多 5,000 个字符。
  • lyrics:最多 5,000 个字符(作为演唱歌词时优先于 prompt)。
  • style:V6 模型上最多 1,000 个字符(旧版 V4 上为 200 个字符)。
  • title:suno-music 上最多 80 个字符(V6 延长和混搭操作上为 100 个字符)。

常见问题

如何从 Suno 导出 MIDI?

在 Suno Studio 中,先从 Stems 面板将片段拆分为分轨,再选中某条分轨并选择 Get MIDI(10 个 Suno 积分)即可下载标准 MIDI 文件[2]。通过 reAPI 上的 Suno MIDI API,则先运行 suno-vocal-separation,再把该已完成分轨任务的 task_id 传入 suno-midi,即可获取结构化的乐器与音符 JSON[4]。

可以在同一条提示词中上传多个 MIDI 文件吗?

不可以。按照 suno-music 当前的 Suno MIDI 要求,midi_urls 每次请求最多接受一个 .mid 或 .midi URL[4]。如果你的编曲把钢琴、贝斯和鼓分在了不同的 DAW 轨道里,请在上传前将它们导出为单个多通道标准 MIDI 文件(最多 16 个通道,小于 256 KB)[1][4]。

为什么 Suno 拒绝了我有效的 .mid 文件?

我们在 2026 年 11 月 19 日的线上测试中出现了两个常见原因:MIDI 时间线短于 6 秒("Minimum duration is 6 seconds"),或者一段裸音阶触发了已知录音匹配("Our system matched this upload to a known recording")。此外,请确认文件以标准的 MThd 二进制文件头开头、体积不超过 256 KB,且通过公开 HTTP(S) URL 而非 data: URI 提供访问[4]。

Suno 是否提供 MIDI 的官方 API 访问?

Suno 并未面向开发者发布通用公开 REST API。其原生 Suno MIDI 功能位于面向 Pro 和 Premier 订阅用户的 Suno 网页应用与 Studio 内[1][3]。构建自动化流水线的开发者会使用统一 API 网关,例如 reAPI 的 Suno API,它通过同一个 Bearer 令牌和异步轮询契约暴露 midi_urls、suno-vocal-separation 和 suno-midi[4]。

使用 MIDI 时 Suno 允许提示词最多输入多少个字符?

在 suno-music 上传入 midi_urls 时,请求运行在灵感模式(custom_mode: false)下,此时 prompt 最多允许 3,000 个字符[4]。在不含 MIDI 附件的自定义模式下,V6 模型上的 prompt 和 lyrics 最多允许 5,000 个字符,style 最多 1,000 个,title 最多 80 个[4]。

我能在真实的 DAW 音乐制作工作流中使用 Suno MIDI 吗?

可以,前提是按两个方向各自的优势来用。从你自己的 DAW MIDI 文件起步生成歌曲,比单靠文本提示词拥有更紧密的和声与结构控制[1]。从 Suno 音频中提取 MIDI 适合用来抓取和弦声部、贝斯线或旋律以便用 DAW 插件重新触发,只要你先干净地做好分轨,并留出几分钟用于量化和清理鬼音即可。

在 Studio 与 API 之间选择 Suno MIDI 工作方式

如果你是个人制作人,需要在 Chrome 中用 USB 键盘即兴演奏、在浏览器时间线上编辑音符,并偶尔手动导出 WAV 分轨或 .mid 文件,选 Suno Studio[2][3]。如果你希望在不按月订阅的情况下在 V6_WILD 上运行 midi_urls、通过程序用 suno-vocal-separation 和 suno-midi 处理上传音频,或直接以 JSON 消费音符数组,选 reAPI HTTP 工作流。无论走哪条路,获得可靠 Suno MIDI 结果都取决于两个习惯:导入时导出时长至少 6 秒的原创多通道 .mid 文件,导出时先仔细分离分轨再进行转写。

可在 reAPI Suno API 文档 中阅读完整参数结构,或直接在 Suno 模型页 的浏览器中测试调用。

参考资料

  1. Suno. Start Songs with MIDI. 发表于 2026 年 11 月 4 日。2026 年 11 月检索自 suno.com/blog/MIDI-in-create
  2. Suno Help Center. Exporting from Studio. 2026 年 11 月检索自 help.suno.com/en/articles/8128193
  3. Suno Help Center. MIDI in Studio. 2026 年 11 月检索自 help.suno.com/en/articles/13670593
  4. reAPI. Suno API 文档。 2026 年 11 月检索自 reapi.ai/docs/suno
  5. reAPI. Suno 模型页与实时定价。 2026 年 11 月检索自 reapi.ai/models/suno

更多文章

全部教程与指南