Suno · 音乐
标签增强
📌 这是什么：把你给的简单风格标签扩展成更丰富的描述。
💡 什么时候用：不知道怎么描述风格、想要更专业的标签时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/suno |
| 查询结果 | GET | /api/cqt/info/suno?id={taskId} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | string | 必填 | 固定填 upsample_tags |
| prompt | string | 必填 | 待增强的风格标签/描述 |
请求示例
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>" }响应示例
{
"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"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码，200 表示成功 |
| msg | string | 提示信息 |
| data.id | string | 任务 ID（= 提交时拿到的 taskId） |
| data.taskType | string | 任务类型，恒为 upsample_tags |
| data.status | string | 任务状态：pending 处理中 / succeeded 成功 / failed 失败 |
| data.param | object | 原样回显你提交的请求参数 |
| data.result | object | ⚠ 对象（非数组），结果在下面两个字段 |
| data.result.upsampled_tags | string | 扩写后的丰富风格描述（可直接喂给 create 的 tags/prompt） |
| data.result.request_id | string | 本次扩写的请求 ID（排查用） |
| data.createTime / completeTime | string | 任务提交时间 / 完成时间 |
计费与积分
1 积分（× 你的用户费率）。任务失败自动退回。