Suno · Music
Generate Lyrics
📌 What is this：Generate lyrics text only (no song).
💡 When to use：Use for lyric ideas or to write words before music.
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: lyrics |
| prompt | string | Required | Lyric theme description |
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":"lyrics", "prompt":"A happy song about a girl and a boy." }'
# -> { "code":200, "data":"<taskId>" }Response Example
{
"code": 200,
"msg": "success",
"data": {
"id": "ff501471da4649848314f29a5da3bb1e",
"taskType": "lyrics",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "lyrics",
"prompt": "A happy song about a girl and a boy."
},
"result": [
{
"tags": ["upbeat, pop, tropical, male vocals", "happy"],
"text": "[Verse] Summer kisses Strawberry limeade … （完整歌词已省略）",
"title": "Summer Kisses",
"status": "complete",
"error_message": ""
},
{
"tags": ["pop, fun, male vocals", "happy"],
"text": "[Verse] Baby blue skies I see you and I … （完整歌词已省略）",
"title": "True",
"status": "complete",
"error_message": ""
}
],
"createTime": "2026-07-08 17:14:49",
"completeTime": "2026-07-08 17:14:59"
}
}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 "lyrics" |
| data.status | string | Status: pending / succeeded / failed |
| data.param | object | Echo of the request params you submitted |
| data.result | array | ⚠ An array, but each item is a lyrics object (no audio/clip); usually 2 candidates |
| data.result[].title | string | AI-generated song title |
| data.result[].text | string | Lyrics body (with [Verse]/[Chorus] section tags) |
| data.result[].tags | string[] | Suggested style tags (can be fed to create’s tags) |
| data.result[].status | string | Per-item status; "complete" = usable |
| data.result[].error_message | string | Per-item failure reason; empty on success |
| data.createTime / completeTime | string | Task submit time / completion time |
Billing & Credits
1 credit (x your user rate). Auto-refunded on failure.