Suno · 音乐生成
用灵感生成
📌 这是什么:基于一个"灵感播放列表"生成符合该风格的新音乐。需先用 playlist_create 拿到 playlistId(旧的 playlist_clip_ids 简化模式已废弃)。
💡 什么时候用:先用 playlist_create 把几首参考歌做成灵感列表,再据此批量产出同风格音乐时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/suno |
| 查询结果 | GET | /api/cqt/info/suno?id={taskId} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | string | 必填 | 固定填 inspiration |
| model | string | 必填 | 模型版本 |
| playlistId | string | 必填 | 灵感播放列表 ID(来自 playlist_create) |
| prompt | string | — | 附加风格描述(可选) |
| personaId | string | — | Vox Persona 模式(可选):配合 artistClipId + personaStyle="vox" 用声音角色演唱 |
高级参数(可选)
| 参数 | 类型 | 说明 |
|---|---|---|
| styleWeight | number(0~1) | 风格权重,越大越贴近 tags 风格 |
| audioWeight | number(0~1) | 原音频影响权重(用于基于音频的任务) |
| weirdnessConstraint | number(0~1) | 创意/怪异度,越大越大胆 |
| personaId | string | 音色/角色 ID(用声音角色演唱) |
| artistClipId | string | 风格参考片段 ID |
请求示例
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>" }响应示例
{
"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"
}
}计费与积分
30 积分(× 你的用户费率)。任务失败自动退回。