分离人声
模型 ID 是 ai-music-api/separate-vocals。先创建任务，再查询结果。Suno 模型页 的试听表单提交同一组字段。
创建任务
POST https://modelfold.ai/api/v1/jobs/createTask
curl https://modelfold.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"ai-music-api/separate-vocals","input":{"type":"separate_vocal"}}'const created = await fetch('https://modelfold.ai/api/v1/jobs/createTask', {
method: 'POST',
headers: { Authorization: 'Bearer ' + process.env.MODELFOLD_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"model":"ai-music-api/separate-vocals","input":{"type":"separate_vocal"}}),
}).then((r) => r.json())也可以同步调用 POST https://modelfold.ai/v1/audio/generations ，请求体把 input 摊平到顶层。歌曲生成通常要几十秒以上，建议走任务接口。
参数
| 字段 | 类型 | 必填 | 含义 |
|---|---|---|---|
task_id | string | 否 | 来源任务 ID |
audio_id | string | 否 | 音频 ID |
audio_url | string | 否 | 音频地址 |
type | string | 否 | 分离模式 |
stem_name | string | 否 | 声部名称 |
价格
默认 separate_vocal 为 10 上游积分（1.5 倍时 15）。指定 stem_name 的 split_stem，或 split_stem_advanced，为 20（1.5 倍时 30）。不指定声部的 split_stem 为 50（1.5 倍时 75）。
加价倍数在站点设置 price_markup 里改。单项上游成本可用 suno_pricing 覆盖。
结果
GET https://modelfold.ai/api/v1/jobs/recordInfo?taskId=TASK_ID
state 为 success 时，resultJson 里有 resultUrls（音频、视频、MIDI 或文本附件），以及 resultObject.sourceTaskId 和 resultObject.tracks[].id。后续接口用这个来源任务 ID 和音轨 ID。失败会退款。
回调
可选 callBackUrl 必须是公网 HTTPS 443 端口。callbackSecret 为 32 到 256 个字符。本站会 POST 下面的事件，并用原始 body 签名。签名是 timestamp.eventId.rawBody 的 HMAC-SHA256，再做 base64，放在 X-ModelFold-Signature。同时有 X-ModelFold-Timestamp 和 X-ModelFold-Event-Id。
{
"event": "task.completed",
"data": { "taskId": "MODELFOLD_TASK_ID", "model": "ai-music-api/separate-vocals", "state": "success" }
}其它 Suno 接口
生成歌曲 · 续写 · 翻唱 · 上传后续写 · 加伴奏 · 加人声 · 混搭 · 替换片段 · 音效 · 音乐视频 · 带时间轴歌词 · 写歌词 · 强化风格 · 转 WAV · 恢复音频 · 封面图 · 音色人格 · MIDI · 创建声音 · 检查声音 · 校验短句 · 重做短句