Suno · Music Generation
Generate from Inspiration
📌 What is this：Generate new music matching the style of an "inspiration playlist".
💡 When to use：Use to batch-produce same-style music from a playlist of reference songs.
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: inspiration |
| model | string | Required | Model version |
| playlistId | string | Required | Inspiration playlist ID |
| prompt | string | — | Optional extra style description |
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":"inspiration", "model":"v55", "playlistId":"119573ff-8e48-..." }'
# -> { "code":200, "data":"<taskId>" }Response Example
{
"code": 200,
"msg": "success",
"data": {
"id": "eb6ef8e92f3a4ef6b05376913349241a",
"taskType": "create",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "create",
"model": "chirp-v50",
"customMode": true,
"makeInstrumental": false,
"prompt": "两只老虎 两只老虎跑得快 一只没有耳朵一只没有尾巴真奇怪 ...",
"tags": "Happy",
"negativeTags": "Sad, Slow",
"title": "两只老虎",
"vocalGender": "f",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65
},
"result": [
{
"id": "4f51f49d-8875-442d-9a66-81a7e66d55d6",
"title": "两只老虎",
"handle": "playfulsubtlety0358",
"status": "complete",
"user_id": "c267a485-9025-44b9-85c1-a9251f0e8f49",
"explicit": false,
"has_hook": false,
"is_liked": false,
"metadata": {
"tags": "Happy",
"type": "gen",
"prompt": "两只老虎 两只老虎跑得快 ...",
"stream": true,
"duration": 91.32,
"has_stem": false,
"is_remix": false,
"priority": 10,
"can_remix": true,
"model_badges": {
"songrow": {
"dark": { "text_color": "FD429C", "border_color": "00000000", "background_color": "FD429C40" },
"light": { "text_color": "FD429C", "border_color": "00000000", "background_color": "FD429C1A" },
"display_name": "v5"
},
"songcard": {
"dark": { "text_color": "FD429C", "border_color": "00000000", "background_color": "0000004D" },
"light": { "text_color": "FD429C", "border_color": "00000000", "background_color": "0000004D" },
"display_name": "v5"
}
},
"negative_tags": "Sad, Slow",
"refund_credits": false,
"control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
"make_instrumental": false,
"uses_latest_model": true
},
"audio_url": "https://cdn1.suno.ai/4f51f49d-8875-442d-9a66-81a7e66d55d6.mp3",
"image_url": "https://cdn2.suno.ai/image_4f51f49d-8875-442d-9a66-81a7e66d55d6.jpeg",
"is_public": false,
"video_url": "",
"created_at": "2026-01-09T11:37:27.101Z",
"flag_count": 0,
"is_trashed": false,
"model_name": "chirp-crow",
"play_count": 0,
"batch_index": 0,
"entity_type": "song_schema",
"display_name": "PlayfulSubtlety0358",
"upvote_count": 0,
"comment_count": 0,
"allow_comments": true,
"image_large_url": "https://cdn2.suno.ai/image_large_4f51f49d-8875-442d-9a66-81a7e66d55d6.jpeg",
"is_contest_clip": false,
"avatar_image_url": "https://cdn1.suno.ai/sAura14.jpg",
"is_handle_updated": false,
"major_model_version": "v5"
},
{
"id": "f64bf2bf-d588-4248-b7e9-0367142c945a",
"title": "两只老虎",
"handle": "playfulsubtlety0358",
"status": "complete",
"user_id": "c267a485-9025-44b9-85c1-a9251f0e8f49",
"explicit": false,
"has_hook": false,
"is_liked": false,
"metadata": {
"tags": "Happy",
"type": "gen",
"prompt": "两只老虎 两只老虎跑得快 ...",
"stream": true,
"duration": 114.96,
"has_stem": false,
"is_remix": false,
"priority": 10,
"can_remix": true,
"negative_tags": "Sad, Slow",
"refund_credits": false,
"control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
"make_instrumental": false,
"uses_latest_model": true
},
"audio_url": "https://cdn1.suno.ai/f64bf2bf-d588-4248-b7e9-0367142c945a.mp3",
"image_url": "https://cdn2.suno.ai/image_f64bf2bf-d588-4248-b7e9-0367142c945a.jpeg",
"is_public": false,
"video_url": "",
"created_at": "2026-01-09T11:37:27.101Z",
"flag_count": 0,
"is_trashed": false,
"model_name": "chirp-crow",
"play_count": 0,
"batch_index": 1,
"entity_type": "song_schema",
"display_name": "PlayfulSubtlety0358",
"upvote_count": 0,
"comment_count": 0,
"allow_comments": true,
"image_large_url": "https://cdn2.suno.ai/image_large_f64bf2bf-d588-4248-b7e9-0367142c945a.jpeg",
"is_contest_clip": false,
"avatar_image_url": "https://cdn1.suno.ai/sAura14.jpg",
"is_handle_updated": false,
"major_model_version": "v5"
}
],
"createTime": "2026-01-09 19:37:16",
"completeTime": "2026-01-09 19:38:57"
}
}Billing & Credits
30 credits (x your user rate). Auto-refunded on failure.