Suno · Music Generation

Merge Two LyricsNEW

📌 What is this：Merge two lyric texts into new lyrics — often a pre-step for mashup. Takes lyric text, not clip IDs.

💡 When to use：Use before mashing up two songs, to first blend their lyrics.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/suno
Query Result	GET	/api/cqt/info/suno?id={taskId}

Request Parameters

Param	Type	Required	Description
task	string	Required	Fixed value: mashupLyrics
lyricsA	string	Required	First lyrics text
lyricsB	string	Required	Second lyrics text

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"mashupLyrics", "lyricsA":"[Verse] ...", "lyricsB":"[Verse] ..." }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "798210cab61c464e8863780463ecb60a",
    "taskType": "mashupLyrics",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "mashupLyrics",
      "lyricsA": "[Verse]\n夜空中最亮的星\n能否听清...",
      "lyricsB": "[Verse]\n海阔天空 在勇敢以后..."
    },
    "result": {
      "text": "[singer A]\n夜空中最亮的星\n能否听清...\n\n[transition]\n\n[singer B]\n海阔天空 在勇敢以后...",
      "title": "Lyrics Mashup"
    },
    "createTime": "2026-07-09 11:31:42",
    "completeTime": "2026-07-09 11:31:48"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit)
data.taskType	string	Task type; always "mashupLyrics"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the lyricsA / lyricsB you submitted
data.result	object	⚠ An object { text, title } (merged lyrics only; no audio/clip)
data.result.text	string	Merged lyrics, tagged with [singer A]/[transition]/[singer B] sections
data.result.title	string	AI-generated title (e.g. "Lyrics Mashup")
data.createTime / completeTime	string	Task submit time / completion time

Billing & Credits

2 credits (x your user rate). Auto-refunded on failure.