接口与鉴权

POST https://top.qingyuntop.ai/suno/submit/lyrics

使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。路径自动选择 suno_lyrics。

参数

字段类型含义与使用条件
promptstring自定义模式为歌词文本；纯音乐可为空。生成歌词接口中则为创作要求，必须非空。

这里的 prompt 是“歌词创作要求”；music 自定义模式的 prompt 则是“已有歌词正文”。无需填写 mv、tags 或 make_instrumental。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/suno/submit/lyrics" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "写一首关于清晨海边的中文民谣歌词，包含两段主歌和一段副歌。"
}'

查询与使用歌词

与歌曲一样，先取得 {"code":"success","message":"","data":"TASK_ID"}，再调用 GET /suno/fetch/{task_id}。成功后读取任务 data 中的 title、text；常见歌词 data 是一个对象，也应兼容数组形式。

查询响应的简化结构示例：

{"code":"success","message":"","data":{"task_id":"TASK_ID","status":"SUCCESS","data":{"id":"LYRICS_ID","title":"海风","text":"清晨的海风轻轻吹来……"}}}

保存 text 为 UTF-8 文本即可。要生成歌曲，将它放入自定义歌词生成歌曲的 prompt。lyrics 成功时没有音频是正常行为。