歌词项目创建 API
接口说明
歌词项目创建用于把生成或编辑后的歌词保存为可在歌词库复用的项目。
接口地址：POST /api/lyrics/projects/create
计费：免费额度内不收费（每个用户每分钟最多 10 次，每天最多 300 次）；超出免费额度后按 0.1 元/次收费。
超限识别：超出免费额度时请求仍会正常执行，响应头会带 X-Suno-Helper-Free: false 和 X-Suno-Helper-Over-Limit: minute（或 day），可据此在客户端提示本次已按次计费。
推荐模型：suno-v6。
认证
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | - | 对客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| title | string | 是 | - | 歌词项目标题 |
| lyrics | string | 否 | - | 完整歌词；传入后会在同一账号内直接写入项目 |
请求示例
curl -X POST https://www.suno-api.io/api/lyrics/projects/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"title": "夏夜海风",
"lyrics": "[Verse]\n夜色落在窗前\n[Chorus]\n我们向光而行"
}'
响应结果
{
"code": 200,
"message": "success",
"data": {
"id": "lyrics_project_id",
"title": "夏夜海风",
"lyrics": "[Verse]\n夜色落在窗前\n[Chorus]\n我们向光而行",
"created_at": "2026-09-15T10:00:00Z",
"updated_at": "2026-09-15T10:00:00Z"
}
}
如果不传 lyrics，可以再调用歌词项目保存 API写入歌词正文；传入 lyrics 时服务端会在同一账号内立即完成保存。