Suno · Music

Enhance Tags

📌 What is this：Expand your simple style tags into a richer description.

💡 When to use：Use when unsure how to describe a style and want better tags.

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: upsample_tags
prompt	string	Required	Style tags/description to enhance

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":"upsample_tags", "prompt":"lofi chill beats" }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "3c571bf96d6b45188a502c20207a64bc",
    "taskType": "upsample_tags",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "upsample_tags",
      "prompt": "lofi chill beats"
    },
    "result": {
      "upsampled_tags": "Dusty lo-fi chill beats at 78 BPM with soft boom-bap kick, brushed snare, and off-grid hi-hats. Warm Rhodes chords through tape saturation, vinyl crackle, mellow sub-bass, and filtered guitar plucks with long delay tails. Gentle sidechain, wide room ambience, and understated swing create a suspended, weightless groove.",
      "request_id": "072792ff-eb35-4325-9820-fc8b9c403289"
    },
    "createTime": "2026-07-08 17:16:08",
    "completeTime": "2026-07-08 17:16:12"
  }
}

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 "upsample_tags"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the request params you submitted
data.result	object	⚠ An object (not an array); result in the two fields below
data.result.upsampled_tags	string	The expanded rich style description (feed to create’s tags/prompt)
data.result.request_id	string	Request ID for this expansion (for troubleshooting)
data.createTime / completeTime	string	Task submit time / completion time

Billing & Credits

1 credit (x your user rate). Auto-refunded on failure.