Suno · 音乐
延伸歌曲
📌 这是什么:把一首已经生成的歌往后接着唱,让它更长。
💡 什么时候用:一首歌太短、想加副歌或继续发展时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/suno |
| 查询结果 | GET | /api/cqt/info/suno?id={taskId} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | string | 必填 | 固定填 extend |
| model | string | 必填 | 模型版本 |
| clipId | string | 必填 | 要延伸的歌曲片段 ID |
| continueAt | number | — | 从第几秒开始续接 |
高级参数(可选)
| 参数 | 类型 | 说明 |
|---|---|---|
| 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":"extend", "model":"v55", "clipId":"6e1f9e23-09f6-43d2-812a-59a154459082", "continueAt":30 }'
# -> { "code":200, "data":"<taskId>" }响应示例
{
"code": 200,
"msg": "success",
"data": {
"id": "95605f2d10624032baabc3b1db41a7e8",
"taskType": "extend",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "extend",
"model": "chirp-v55",
"clipId": "6e1f9e23-09f6-43d2-812a-59a154459082",
"continueAt": 30
},
"result": [
{
"id": "3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176",
"title": "",
"handle": "ernabillstbwsd",
"status": "complete",
"user_id": "f04d4d05-dd5c-4f54-ac37-3357099b2ce1",
"metadata": {
"tags": "",
"task": "extend",
"type": "gen",
"prompt": "",
"duration": 73.68,
"is_remix": true,
"continue_at": 30,
"edited_clip_id": "6e1f9e23-09f6-43d2-812a-59a154459082",
"history": [
{ "id": "6e1f9e23-09f6-43d2-812a-59a154459082", "type": "gen", "source": "ios", "continue_at": 30 }
],
"make_instrumental": false,
"uses_latest_model": true
},
"audio_url": "https://cdn1.suno.ai/3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.mp3",
"video_url": "https://cdn1.suno.ai/3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.mp4",
"image_url": "https://cdn2.suno.ai/image_3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.jpeg",
"clip_roots": {
"clips": [
{
"id": "6e1f9e23-09f6-43d2-812a-59a154459082",
"title": "Książę z Mroczną Przeszłością",
"image_url": "https://cdn2.suno.ai/image_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
"user_handle": "ernabillstbwsd",
"user_display_name": "ernabillstbwsd"
}
],
"clip_attribution_type": "remix"
},
"media_urls": [
{ "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
{ "url": "https://cdn1.suno.ai/3c7a9faf-81b4-4bc1-8ee1-1bfc8f07c176.mp3", "delivery": "progressive", "content_type": "mp3" }
],
"model_name": "chirp-fenix",
"batch_index": 0,
"created_at": "2026-07-08T06:41:34.279Z",
"major_model_version": "v5.5"
},
{
"id": "c01622cb-8159-4865-91af-754ed215b51c",
"title": "",
"status": "complete",
"metadata": {
"task": "extend",
"duration": 44.4,
"is_remix": true,
"continue_at": 30,
"avg_bpm": 83.99,
"history": [
{ "id": "6e1f9e23-09f6-43d2-812a-59a154459082", "type": "gen", "continue_at": 30 }
]
},
"audio_url": "https://cdn1.suno.ai/c01622cb-8159-4865-91af-754ed215b51c.mp3",
"video_url": "https://cdn1.suno.ai/c01622cb-8159-4865-91af-754ed215b51c.mp4",
"image_url": "https://cdn2.suno.ai/image_c01622cb-8159-4865-91af-754ed215b51c.jpeg",
"model_name": "chirp-fenix",
"batch_index": 1,
"major_model_version": "v5.5"
}
],
"createTime": "2026-07-08 14:41:32",
"completeTime": "2026-07-08 14:43:08"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码,200 表示成功 |
| msg | string | 提示信息 |
| data.id | string | 任务 ID(= 提交时拿到的 taskId,用于轮询查询) |
| data.taskType | string | 任务类型,与提交的 task 一致 |
| data.status | string | 任务状态:pending 处理中 / succeeded 成功 / failed 失败 |
| data.errorMsg | string | 失败原因,成功时为空 |
| data.param | object | 原样回显你提交的请求参数 |
| data.result | array | 生成结果,一次返回 2 条候选片段 |
| data.result[].id | string | 生成片段的 clipId,可继续用于再次 extend / cover 等 |
| data.result[].audio_url | string | 音频文件地址(mp3) |
| data.result[].video_url | string | 视频文件地址(mp4),有时为空需稍后再查 |
| data.result[].image_url | string | 封面图地址(image_large_url 为大图) |
| data.result[].title | string | 歌曲标题 |
| data.result[].status | string | 片段状态,complete 表示可下载 |
| data.result[].metadata.duration | number | 音频总时长(秒) |
| data.result[].metadata.tags | string | 风格标签 |
| data.result[].metadata.continue_at | number | 从原曲第几秒开始续接 |
| data.result[].metadata.history | array | 溯源链:从哪个 clip、第几秒续接而来 |
| data.result[].metadata.is_remix | bool | 是否二次创作,extend 恒为 true |
| data.result[].clip_roots | object | 源片段(父曲)信息:标题 / 封面 / 作者 |
| data.result[].media_urls | array | 多格式音频地址(m4a-opus / mp3) |
| data.result[].batch_index | number | 候选序号(0、1) |
| data.result[].major_model_version | string | 生成所用模型版本,如 v4.5 / v5.5 |
| data.createTime / completeTime | string | 任务提交时间 / 完成时间 |
| 其它字段 | — | action_config / model_badges / secondary_badges / ownership / avatar_image_url 等为 Suno 前端展示用,可忽略 |
计费与积分
30 积分(× 你的用户费率)。任务失败自动退回。