Generate lyrics

After submission, save data.jobId and use Retrieve a task to obtain lyric candidates. lyrics_model supports classic and remi; if omitted, it defaults to classic.

After the task completes, lyric candidates are in data.data.data.lyrics. Each item returns complete lyrics in prompt and also contains title and tags. Do not read a text field that is not returned.

POST/suno/mj/submit/lyrics

Authorization

bearerAuth

AuthorizationBearer <token>

Authenticate with Authorization: Bearer your-api-key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*string

Lyrics generation prompt, with a maximum length of 500 characters.

Lengthlength <= 500

lyrics_model?string

Lyrics model. Supports classic and remi; defaults to classic.

Default"classic"

Value in

"classic"
"remi"

hookUrl?string

Optional user callback URL. Only ports 80, 443, 8080, and 8443 are supported. When provided, the platform forwards notifications to it.

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": "Write pop lyrics about a reunion by the sea on a summer night, with a memorable chorus",
  "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`