生成歌词

提交成功后保存 data.jobId，通过查询任务获取歌词候选。lyrics_model 支持 classic 和 remi；省略时使用 classic。

查询任务完成后，歌词候选位于响应的 data.data.data.lyrics。每项使用 prompt 返回完整歌词，并包含 title 和 tags；不要读取未返回的 text 字段。

POST/suno/mj/submit/lyrics

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization: Bearer your-api-key 认证。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*string

歌词生成提示词，长度上限 500 字符。

Lengthlength <= 500

lyrics_model?string

歌词模型；支持 classic、remi，默认 classic。

Default"classic"

Value in

"classic"
"remi"

hookUrl?string

可选的用户回调地址。仅支持 80、443、8080、8443 端口；填写后由平台转发通知。

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/lyrics' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "写一首关于夏夜海边重逢的中文流行歌词，副歌要有记忆点",
  "lyrics_model": "classic"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

429application/json

`application/json`

`application/json`

`application/json`