Suno · 音乐
声音角色NEW
📌 这是什么：从一段歌里提取一个"嗓音角色"，之后可以用它来唱别的歌。
💡 什么时候用：想固定用某个声线来生成多首歌时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/suno |
| 查询结果 | GET | /api/cqt/info/suno?id={taskId} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | string | 必填 | 固定填 persona |
| clipId | string | 必填 | 提供嗓音的源片段 ID |
| name | string | 必填 | 角色名称 |
| description | string | — | 角色描述，如"soulful R&B voice" |
| is_public | bool | — | 是否公开该角色，默认 false |
| persona_type | string | — | 角色类型，如 vox（嗓音） |
| vox_audio_id | string | — | 嗓音音频 ID（用于提取音色） |
| vocal_start_s | number | — | 人声片段起始秒 |
| vocal_end_s | number | — | 人声片段结束秒 |
| user_input_styles | string | — | 风格描述，如"soulful vocals, R&B, smooth harmonies" |
请求示例
curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{ "task":"persona", "clipId":"6e1f9e23-09f6-43d2-812a-59a154459082", "name":"My Vocal Persona", "description":"A soulful R&B voice", "is_public":true, "persona_type":"vox", "vox_audio_id":"373efa9c-a366-42bb-806c-afdfc9b306a7", "vocal_start_s":16.13, "vocal_end_s":46.13, "user_input_styles":"soulful vocals, R&B, smooth harmonies" }'
# -> { "code":200, "data":"<taskId>" }响应示例
{
"code": 200,
"msg": "success",
"data": {
"id": "692bc16760a940bfbe0d450cdcf7b69e",
"taskType": "persona",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "persona",
"clipId": "6e1f9e23-09f6-43d2-812a-59a154459082",
"name": "My Vocal Persona",
"description": "A soulful R&B voice",
"is_public": true,
"persona_type": "vox",
"vox_audio_id": "373efa9c-a366-42bb-806c-afdfc9b306a7",
"vocal_start_s": 16.13,
"vocal_end_s": 46.13,
"user_input_styles": "soulful vocals, R&B, smooth harmonies"
},
"result": {
"id": "65db3557-9864-4625-b237-b715ca0bb951",
"name": "My Vocal Persona",
"description": "A soulful R&B voice",
"image_s3_id": "https://cdn2.suno.ai/image_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
"root_clip_id": "6e1f9e23-09f6-43d2-812a-59a154459082",
"clip": {
"status": "complete",
"title": "Książę z Mroczną Przeszłością",
"id": "6e1f9e23-09f6-43d2-812a-59a154459082",
"entity_type": "song_schema",
"audio_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp3",
"video_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp4",
"image_url": "https://cdn2.suno.ai/image_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "male,powerful, gritty, epic",
"type": "gen",
"duration": 202.68,
"stream": true,
"make_instrumental": false,
"control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
"can_remix": true,
"is_remix": false
},
"user_id": "f04d4d05-dd5c-4f54-ac37-3357099b2ce1",
"display_name": "ernabillstbwsd",
"handle": "ernabillstbwsd",
"created_at": "2026-07-08T06:28:41.038Z",
"is_public": false,
"batch_index": 0
},
"user_display_name": "ernabillstbwsd",
"user_handle": "ernabillstbwsd",
"user_image_url": "https://cdn1.suno.ai/sAura10.jpg",
"persona_clips": [
{ "id": 350960734, "clip": { "id": "6e1f9e23-09f6-43d2-812a-59a154459082", "status": "complete", "title": "Książę z Mroczną Przeszłością", "audio_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp3" } }
],
"is_owned": true,
"is_public": true,
"upvote_count": 0,
"clip_count": 1,
"persona_type": "vox",
"source": "generated_clip",
"user_input_styles": "soulful vocals, R&B, smooth harmonies",
"vocal_start_s": 0.1,
"vocal_end_s": 30,
"vocal_clip_id": "95667adc-571f-4cc5-8624-d654d67c1f4d"
},
"createTime": "2026-07-08 14:31:59",
"completeTime": "2026-07-08 14:32:15"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码，200 表示成功 |
| msg | string | 提示信息 |
| data.id | string | 任务 ID（= 提交时拿到的 taskId，用于轮询查询） |
| data.taskType | string | 任务类型，恒为 persona |
| data.status | string | 任务状态：pending 处理中 / succeeded 成功 / failed 失败 |
| data.errorMsg | string | 失败原因，成功时为空 |
| data.param | object | 原样回显你提交的请求参数 |
| data.result | object | ⚠ 这里是对象（不是数组），即提取出的嗓音角色 |
| data.result.id | string | 角色 ID（personaId），后续创作可引用此嗓音 |
| data.result.name / description | string | 角色名称 / 描述 |
| data.result.persona_type | string | 角色类型，如 vox（嗓音） |
| data.result.root_clip_id | string | 来源歌曲片段 ID |
| data.result.clip | object | 来源片段完整信息（audio_url / video_url / image_url / metadata 等） |
| data.result.persona_clips | array | 使用该角色的片段列表 |
| data.result.vocal_start_s / vocal_end_s | number | 采样的人声区间（秒） |
| data.createTime / completeTime | string | 任务提交时间 / 完成时间 |
计费与积分
5 积分（× 你的用户费率）。任务失败自动退回。