POST
/suno/submit/music生成歌曲(灵感模式)
API Key application/json
请求示例
curl -X POST https://top.qingyuntop.ai/suno/submit/music \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"gpt_description_prompt": "一首动听的情歌",
"make_instrumental": false,
"mv": "chirp-v4",
"prompt": "Cat Dance"
}'请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | Header | string | 是 | - | application/json |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 否 | - | Bearer {{YOUR_API_KEY}} |
prompt | JSON body | string | 是 | 歌词内容，仅用于自定义模式 | - |
mv | JSON body | string | 是 | 模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0 | - |
title | JSON body | string | 否 | 歌曲标题，仅用于自定义模式 | - |
tags | JSON body | string | 否 | 风格标签，仅用于自定义模式，多个标签用半角逗号分隔 | - |
make_instrumental | JSON body | boolean | 否 | 是否生成纯音乐版本，true 表示生成纯音乐 | - |
task_id | JSON body | string | 否 | 任务ID，用于对已有任务进行操作（如续写） | - |
continue_at | JSON body | number | 否 | 续写起始时间点，浮点数，单位为秒 | - |
continue_clip_id | JSON body | string | 否 | 需要续写的歌曲ID | - |
gpt_description_prompt | JSON body | string | 是 | 创作描述提示词，仅用于灵感模式 | - |
notify_hook | JSON body | string | 否 | 任务完成后的回调通知地址 | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
code | 响应 JSON | string | 是 | - | - |
data | 响应 JSON | string | 是 | - | - |
message | 响应 JSON | string | 是 | - | - |
响应示例
{
"code": "success",
"data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
"message": ""
}来源原始接口定义（用于追溯）
以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899759,
"name": "生成歌曲(灵感模式)",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/suno/submit/music",
"tags": [],
"status": 1,
"requestBody": {
"type": "application/json",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"prompt": {
"description": "歌词内容，仅用于自定义模式",
"type": "string"
},
"mv": {
"description": "模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0",
"type": "string"
},
"title": {
"description": "歌曲标题，仅用于自定义模式",
"type": "string"
},
"tags": {
"description": "风格标签，仅用于自定义模式，多个标签用半角逗号分隔",
"type": "string"
},
"make_instrumental": {
"description": "是否生成纯音乐版本，true 表示生成纯音乐",
"type": "boolean"
},
"task_id": {
"description": "任务ID，用于对已有任务进行操作（如续写）",
"type": "string"
},
"continue_at": {
"description": "续写起始时间点，浮点数，单位为秒",
"type": "number"
},
"continue_clip_id": {
"description": "需要续写的歌曲ID",
"type": "string"
},
"gpt_description_prompt": {
"description": "创作描述提示词，仅用于灵感模式",
"type": "string"
},
"notify_hook": {
"description": "任务完成后的回调通知地址",
"type": "string"
}
},
"required": [
"prompt",
"mv",
"gpt_description_prompt"
],
"x-apifox-orders": [
"prompt",
"mv",
"title",
"tags",
"make_instrumental",
"task_id",
"continue_at",
"continue_clip_id",
"gpt_description_prompt",
"notify_hook"
]
},
"examples": [
{
"value": "{\n \"gpt_description_prompt\": \"一首动听的情歌\",\n \"make_instrumental\": false,\n \"mv\": \"chirp-v4\",\n \"prompt\": \"Cat Dance\"\n}",
"mediaType": "application/json",
"description": ""
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": [
{
"id": "NQs7bxnpZf",
"name": "Content-Type",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "qb8tEQbCty",
"name": "Accept",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "gBxcCbXhsa",
"name": "Authorization",
"required": false,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "Bearer {{YOUR_API_KEY}}"
}
]
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {},
"responses": [
{
"id": 145740318,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"data",
"message"
],
"x-apifox-orders": [
"code",
"data",
"message"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 145740318,
"data": "{\r\n \"code\": \"success\",\r\n \"data\": \"950bf3af-78a6-420e-8c01-3bde0bbb3ef9\",\r\n \"message\": \"\"\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b22-7309-aeea-6845da38462e"
},
{
"name": "成功示例",
"responseId": 145740318,
"data": "{\r\n \"code\": \"success\",\r\n \"data\": \"5d213d47-51eb-4887-b3b6-34e6d816ca37\",\r\n \"message\": \"\"\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fd25e-4dff-7728-a95d-9839614841df"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436137,
"ordering": 0,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {},
"isDefaultUrlEncoding": 1
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}