Suno · Music
Fade In / OutNEW
📌 What is this：Add a fade-in at the start or fade-out at the end.
💡 When to use：Use to smooth a song’s start or ending.
Endpoints
| Usage | Method | Path |
|---|---|---|
| Submit task | POST | /api/cqt/generator/suno |
| Query Result | GET | /api/cqt/info/suno?id={taskId} |
Request Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| task | string | Required | Fixed value: audioFade |
| clipId | string | Required | Source clip ID |
| fadeInTime | number | — | Fade-in end time (seconds); either this or fadeOutTime |
| fadeOutTime | number | — | Fade-out start time (seconds); either this or fadeInTime |
| title | string | — | Title after the op (optional) |
Request Example
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>" }Response Example
{
"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"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
| code | number | Status code; 200 = success |
| msg | string | Message |
| data.id | string | Task ID (the taskId returned on submit) |
| data.taskType | string | Task type; always "audioFade" |
| data.status | string | Status: pending / succeeded / failed |
| data.param | object | Echo of the request params you submitted |
| data.result | object | ⚠ An object { clip, status, action_clip_id }; the result is under result.clip |
| data.result.action_clip_id | string | Resulting clip ID (= result.clip.id) |
| data.result.clip.id | string | The faded clip’s clipId |
| data.result.clip.title | string | Title (inherited from the source song) |
| data.result.clip.audio_url | string | Processed audio URL (mp3) |
| data.result.clip.image_url | string | Cover image URL (image_large_url is the large one) |
| data.result.clip.status | string | Clip status; "complete" = ready to download |
| data.result.clip.metadata.type | string | Underlying type: edit_fade |
| data.result.clip.metadata.edited_clip_id | string | Source clip ID processed (= the clipId you passed) |
| data.result.clip.metadata.duration | number | Total audio duration (seconds) |
| data.result.clip.media_urls | array | Multi-format audio URLs (m4a-opus / mp3) |
| data.createTime / completeTime | string | Task submit time / completion time |
| 其它字段 | — | clip_roots (source info) / action_config / model_badges, etc. are for Suno UI |
Billing & Credits
2 credits (x your user rate). Auto-refunded on failure.