写歌词

模型 ID 是 ai-music-api/generate-lyrics。先创建任务，再查询结果。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/generate-lyrics","input":{"prompt":"a short song about morning light"}}'

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/generate-lyrics","input":{"prompt":"a short song about morning light"}}),
}).then((r) => r.json())

也可以同步调用 POST https://modelfold.ai/v1/audio/generations ，请求体把 input 摊平到顶层。歌曲生成通常要几十秒以上，建议走任务接口。

参数

字段	类型	必填	含义
prompt	string	是	提示词

价格

每次上游成本 0.4 积分。售价 = ceil(成本 × 加价倍数)。默认 1.5 倍时是 1 积分。

加价倍数在站点设置 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/generate-lyrics", "state": "success" }
}

其它 Suno 接口

生成歌曲 · 续写 · 翻唱 · 上传后续写 · 加伴奏 · 加人声 · 混搭 · 分离人声 · 替换片段 · 音效 · 音乐视频 · 带时间轴歌词 · 强化风格 · 转 WAV · 恢复音频 · 封面图 · 音色人格 · MIDI · 创建声音 · 检查声音 · 校验短句 · 重做短句