Suno · Music
Reuse Style with New Lyrics
📌 What is this：Keep a song’s style but swap in your new lyrics.
💡 When to use：Use when you like a song’s vibe and want to sing new content in it.
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: use_styles_lyrics |
| model | string | Required | Model version |
| clipId | string | Required | Source clip ID providing the style |
| prompt | string | Required | New lyrics |
Advanced Parameters (optional)
| Param | Type | Description |
|---|---|---|
| styleWeight | number(0~1) | Style weight; higher sticks closer to tags |
| audioWeight | number(0~1) | Original-audio influence weight (for audio-based tasks) |
| weirdnessConstraint | number(0~1) | Creativity / weirdness; higher is bolder |
| personaId | string | Voice persona ID (sing with a persona) |
| artistClipId | string | Reference clip ID for style |
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":"use_styles_lyrics", "model":"v55", "clipId":"5751729f-66f7-493c-bf22-4c4cda6cb0bd", "prompt":"[Verse]\nNew lyrics here" }'
# -> { "code":200, "data":"<taskId>" }Response Example
{
"code": 200,
"msg": "success",
"data": {
"id": "ebff480d76c74b5fa9a52c72a0756d36",
"taskType": "use_styles_lyrics",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "use_styles_lyrics",
"model": "chirp-v55",
"clipId": "5751729f-66f7-493c-bf22-4c4cda6cb0bd",
"prompt": "[Verse]\nNew lyrics here"
},
"result": [
{
"id": "c3547068-6fba-46f1-851b-d4856d63a5ce",
"title": "New Lyrics Here",
"handle": "ardythpittt3yct",
"status": "complete",
"user_id": "378a7634-98a4-47fa-98b9-36246ef84f11",
"metadata": {
"tags": "Pop with mid-tempo four-on-the-floor drums … （自动生成的风格描述已省略）",
"type": "gen",
"prompt": "[Verse 1] I folded up the old page … （完整歌词已省略）",
"duration": 157.08,
"is_remix": true,
"make_instrumental": false,
"uses_latest_model": true,
"styles_lyrics_clip_id": "5751729f-66f7-493c-bf22-4c4cda6cb0bd",
"gpt_description_prompt": "[Verse]\nNew lyrics here"
},
"audio_url": "https://cdn1.suno.ai/c3547068-6fba-46f1-851b-d4856d63a5ce.mp3",
"image_url": "https://cdn2.suno.ai/image_c3547068-6fba-46f1-851b-d4856d63a5ce.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_c3547068-6fba-46f1-851b-d4856d63a5ce.jpeg",
"video_url": "",
"clip_roots": {
"clips": [
{ "user_handle": "roselinhobbui3xs", "user_display_name": "roselinhobbui3xs" }
],
"clip_attribution_type": "remix"
},
"media_urls": [
{ "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/c3547068-6fba-46f1-851b-d4856d63a5ce.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
{ "url": "https://cdn1.suno.ai/c3547068-6fba-46f1-851b-d4856d63a5ce.mp3", "delivery": "progressive", "content_type": "mp3" }
],
"model_name": "chirp-fenix",
"batch_index": 0,
"display_tags": "pop, dance",
"created_at": "2026-07-09T01:32:19.186Z",
"major_model_version": "v5.5"
},
{
"id": "5f7911d0-7b8e-4cc4-adf7-94ae0a3507df",
"title": "New Lyrics Here",
"status": "complete",
"metadata": {
"type": "gen",
"avg_bpm": 128.42,
"duration": 150.88,
"is_remix": true,
"styles_lyrics_clip_id": "5751729f-66f7-493c-bf22-4c4cda6cb0bd",
"gpt_description_prompt": "[Verse]\nNew lyrics here"
},
"audio_url": "https://cdn1.suno.ai/5f7911d0-7b8e-4cc4-adf7-94ae0a3507df.mp3",
"image_url": "https://cdn2.suno.ai/image_5f7911d0-7b8e-4cc4-adf7-94ae0a3507df.jpeg",
"batch_index": 1,
"display_tags": "pop, dance",
"major_model_version": "v5.5"
}
],
"createTime": "2026-07-09 09:32:13",
"completeTime": "2026-07-09 09:34:53"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
| code | number | Status code; 200 = success |
| msg | string | Message |
| data.id | string | Task ID (the taskId returned on submit; used to poll) |
| data.taskType | string | Task type; matches the submitted task |
| data.status | string | Status: pending / succeeded / failed |
| data.errorMsg | string | Failure reason; empty on success |
| data.param | object | Echo of the request params you submitted |
| data.result | array | Results; returns 2 candidate clips |
| data.result[].id | string | The generated clipId; reusable for further extend / cover, etc. |
| data.result[].audio_url | string | Audio file URL (mp3) |
| data.result[].video_url | string | Video file URL (mp4); may be empty, re-query later |
| data.result[].image_url | string | Cover image URL (image_large_url is the large one) |
| data.result[].title | string | Song title |
| data.result[].status | string | Clip status; "complete" = ready to download |
| data.result[].metadata.duration | number | Total audio duration (seconds) |
| data.result[].metadata.tags | string | Style tags |
| data.result[].metadata.styles_lyrics_clip_id | string | Source clip ID that provided the style (= the clipId you passed) |
| data.result[].metadata.gpt_description_prompt | string | Your new lyrics (echo of prompt) |
| data.result[].metadata.tags | string | Auto-generated detailed style descriptor inherited from the source song |
| data.result[].display_tags | string | Concise style tags, e.g. "pop, dance" |
| data.result[].metadata.is_remix | bool | Whether it is a remix; always true for use_styles_lyrics |
| data.result[].clip_roots | object | Source (parent) clip info: title / cover / author |
| data.result[].media_urls | array | Multi-format audio URLs (m4a-opus / mp3) |
| data.result[].batch_index | number | Candidate index (0, 1) |
| data.result[].major_model_version | string | Model version used, e.g. v4.5 / v5.5 |
| data.createTime / completeTime | string | Task submit time / completion time |
| 其它字段 | — | action_config / model_badges / secondary_badges / ownership / avatar_image_url, etc. are for Suno UI and can be ignored |
Billing & Credits
30 credits (x your user rate). Auto-refunded on failure.