Suno · Music
Mashup Two Songs
📌 What is this：Blend two songs into a new one.
💡 When to use：Use to combine two songs you like.
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: mashup |
| model | string | Required | Model version |
| mashupClipIds | array | Required | The two clip IDs to mash up (exactly 2) |
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":"mashup", "model":"v55", "mashupClipIds":["e375e06c-d947-449b-9400-a4cba2bd8160","064bdc20-9c1e-4bfe-ac4c-9d95b85c0817"] }'
# -> { "code":200, "data":"<taskId>" }Response Example
{
"code": 200,
"msg": "success",
"data": {
"id": "1f9febe63ecd485281213a05a9cad21c",
"taskType": "mashup",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "mashup",
"model": "chirp-v55",
"mashupClipIds": ["e375e06c-d947-449b-9400-a4cba2bd8160", "064bdc20-9c1e-4bfe-ac4c-9d95b85c0817"]
},
"result": [
{
"id": "2605504f-ce42-4ca2-b64b-3c05269d5b0e",
"title": "Patchwork Parade",
"handle": "maressabocklit7c",
"status": "complete",
"user_id": "3bfb8505-eae1-4dce-8813-2d5b165543fd",
"metadata": {
"tags": "Pop-rap mashup with glitchy drum chops, swung trap hats … （自动生成的风格描述已省略）, mashup",
"task": "mashup_condition",
"type": "gen",
"prompt": "[Verse 1] Woke up in silk and denim With a map in my hand … （完整歌词已省略）",
"avg_bpm": 122.58,
"max_bpm": 150,
"min_bpm": 65.22,
"duration": 230.68,
"is_remix": true,
"has_vocal": false,
"mashup_clip_ids": ["e375e06c-d947-449b-9400-a4cba2bd8160", "064bdc20-9c1e-4bfe-ac4c-9d95b85c0817"],
"make_instrumental": false,
"uses_latest_model": true,
"can_publish_with_vocal": true,
"gpt_description_prompt": "A creative mashup song"
},
"audio_url": "https://cdn1.suno.ai/2605504f-ce42-4ca2-b64b-3c05269d5b0e.mp3",
"image_url": "https://cdn2.suno.ai/image_2605504f-ce42-4ca2-b64b-3c05269d5b0e.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_2605504f-ce42-4ca2-b64b-3c05269d5b0e.jpeg",
"video_url": "",
"clip_roots": {
"clips": [
{ "user_handle": "rositabadgercldrq", "user_display_name": "rositabadgercldrq" },
{ "user_handle": "dorialeuapts", "user_display_name": "dorialeuapts" }
],
"clip_attribution_type": "remix"
},
"media_urls": [
{ "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/2605504f-ce42-4ca2-b64b-3c05269d5b0e.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
{ "url": "https://cdn1.suno.ai/2605504f-ce42-4ca2-b64b-3c05269d5b0e.mp3", "delivery": "progressive", "content_type": "mp3" }
],
"model_name": "chirp-fenix",
"batch_index": 0,
"display_tags": "pop-rap, trap, mashup",
"created_at": "2026-07-08T07:56:11.338Z",
"major_model_version": "v5.5"
},
{
"id": "6a783499-c766-4eab-bc21-6dfb5a55c7d3",
"title": "Patchwork Parade",
"status": "complete",
"metadata": {
"task": "mashup_condition",
"duration": 231.6,
"is_remix": true,
"has_vocal": false,
"mashup_clip_ids": ["e375e06c-d947-449b-9400-a4cba2bd8160", "064bdc20-9c1e-4bfe-ac4c-9d95b85c0817"],
"gpt_description_prompt": "A creative mashup song"
},
"audio_url": "https://cdn1.suno.ai/6a783499-c766-4eab-bc21-6dfb5a55c7d3.mp3",
"image_url": "https://cdn2.suno.ai/image_6a783499-c766-4eab-bc21-6dfb5a55c7d3.jpeg",
"batch_index": 1,
"display_tags": "pop-rap, trap, mashup",
"major_model_version": "v5.5"
}
],
"createTime": "2026-07-08 15:56:09",
"completeTime": "2026-07-08 15:59:46"
}
}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.task | string | For mashup, the clip metadata.task shows "mashup_condition" |
| data.result[].metadata.mashup_clip_ids | array | Source clip IDs mashed up (= the mashupClipIds you passed) |
| data.result[].metadata.gpt_description_prompt | string | Mashup style description (AI-generated) |
| data.result[].metadata.avg_bpm | number | Average tempo in BPM (also max_bpm/min_bpm) |
| data.result[].metadata.has_vocal | bool | Whether it contains vocals |
| data.result[].display_tags | string | Detected style tags, e.g. "pop-rap, trap, mashup" |
| data.result[].metadata.is_remix | bool | Whether it is a remix; always true for mashup |
| 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.