POST
/
api
/
v1
/
lyrics
生成歌词
curl --request POST \
  --url https://api.sunoapi.org/api/v1/lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一首关于城市宁静夜晚的歌",
  "callBackUrl": "https://api.example.com/callback"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

使用指南

  • 此接口仅根据您的提示生成歌词内容
  • 将返回多个歌词变体供您选择
  • 生成的歌词通常包含歌曲结构标记(例如[Verse]、[Chorus])

开发者注意事项

  1. 生成的歌词将保留15天
  2. 回调只有一个阶段:complete(生成完成)
  3. 当您只需要创建歌词而不需要音乐时使用此接口
  4. 结果可以作为自定义模式下生成音乐接口的输入

Authorizations

Authorization
string
header
required

🔑 API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式

在请求头中添加:

Authorization: Bearer YOUR_API_KEY

⚠️ 注意:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.