Suno · 音乐
淡入 / 淡出NEW
📌 这是什么：给音频加开头渐入或结尾渐出效果。
💡 什么时候用：想让歌曲开头/结尾更自然时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/suno |
| 查询结果 | GET | /api/cqt/info/suno?id={taskId} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task | string | 必填 | 固定填 audioFade |
| clipId | string | 必填 | 源片段 ID |
| fadeInTime | number | — | 淡入结束时间（秒），与 fadeOutTime 二选一 |
| fadeOutTime | number | — | 淡出开始时间（秒），与 fadeInTime 二选一 |
| title | string | — | 操作后标题（可选） |
请求示例
curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{ "task":"audioFade", "clipId":"ddd21db0-ae49-4637-95e3-74ae14979e74", "fadeInTime":2, "fadeOutTime":3 }'
# -> { "code":200, "data":"<taskId>" }响应示例
{
"code": 200,
"msg": "success",
"data": {
"id": "f39c996a7e5a4a6f90cd4181d16f3555",
"taskType": "audioFade",
"status": "succeeded",
"errorMsg": "",
"param": {
"task": "audioFade",
"clipId": "ddd21db0-ae49-4637-95e3-74ae14979e74",
"fadeInTime": 2,
"fadeOutTime": 3
},
"result": {
"clip": {
"id": "e51a55f3-68ea-4ea2-aad0-56588f979886",
"title": "Gentle Strength",
"handle": "glennieboyerd3meo",
"status": "complete",
"user_id": "a787941b-2336-413d-b932-5c62a3b296f3",
"metadata": {
"tags": "instrumental,柔和, 强劲, 旋律感强, instrumental",
"type": "edit_fade",
"prompt": "[Instrumental]",
"duration": 174.92,
"is_remix": true,
"edited_clip_id": "ddd21db0-ae49-4637-95e3-74ae14979e74",
"uses_latest_model": false,
"can_publish_with_vocal": true
},
"audio_url": "https://cdn1.suno.ai/e51a55f3-68ea-4ea2-aad0-56588f979886.mp3",
"image_url": "https://cdn2.suno.ai/image_e51a55f3-68ea-4ea2-aad0-56588f979886.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_e51a55f3-68ea-4ea2-aad0-56588f979886.jpeg",
"video_url": "",
"clip_roots": {
"clips": [
{
"id": "ddd21db0-ae49-4637-95e3-74ae14979e74",
"title": "Gentle Strength",
"image_url": "https://cdn2.suno.ai/image_ddd21db0-ae49-4637-95e3-74ae14979e74.jpeg",
"user_handle": "glennieboyerd3meo",
"user_display_name": "glennieboyerd3meo"
}
],
"clip_attribution_type": "remix"
},
"media_urls": [
{ "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/e51a55f3-68ea-4ea2-aad0-56588f979886.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
{ "url": "https://cdn1.suno.ai/e51a55f3-68ea-4ea2-aad0-56588f979886.mp3", "delivery": "progressive", "content_type": "mp3" }
],
"model_name": "chirp-v4",
"batch_index": 0,
"created_at": "2026-07-09T03:42:40.416Z",
"major_model_version": "v4"
},
"status": "complete",
"action_clip_id": "e51a55f3-68ea-4ea2-aad0-56588f979886"
},
"createTime": "2026-07-09 11:42:25",
"completeTime": "2026-07-09 11:42:52"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码，200 表示成功 |
| msg | string | 提示信息 |
| data.id | string | 任务 ID（= 提交时拿到的 taskId） |
| data.taskType | string | 任务类型，恒为 audioFade |
| data.status | string | 任务状态：pending 处理中 / succeeded 成功 / failed 失败 |
| data.param | object | 原样回显你提交的请求参数 |
| data.result | object | ⚠ 对象 { clip, status, action_clip_id }，成品在 result.clip |
| data.result.action_clip_id | string | 产物片段 ID（= result.clip.id） |
| data.result.clip.id | string | 淡入淡出后成品的 clipId |
| data.result.clip.title | string | 标题（沿用源曲） |
| data.result.clip.audio_url | string | 处理后音频地址（mp3） |
| data.result.clip.image_url | string | 封面图地址（image_large_url 为大图） |
| data.result.clip.status | string | 片段状态，complete 表示可下载 |
| data.result.clip.metadata.type | string | 底层类型，edit_fade（淡入淡出） |
| data.result.clip.metadata.edited_clip_id | string | 被处理的源片段 ID（= 你传的 clipId） |
| data.result.clip.metadata.duration | number | 音频总时长（秒） |
| data.result.clip.media_urls | array | 多格式音频地址（m4a-opus / mp3） |
| data.createTime / completeTime | string | 任务提交时间 / 完成时间 |
| 其它字段 | — | clip_roots（源曲信息）/ action_config / model_badges 等为 Suno 前端展示用，可忽略 |
计费与积分
2 积分（× 你的用户费率）。任务失败自动退回。