Remove section API
Endpoint description
Remove section deletes one time range from an existing song and joins the remaining parts into a new version.
Endpoint: POST /api/music/remove-section
Billing: Paid, billed by the requested model; the amount actually charged follows the back-office price configuration.
Recommended model: suno-v6. suno-v6, suno-v6-wild and suno-v6-mini are available.
Wait times and timeouts (important): this is a synchronous endpoint — the order is only accepted and handed to generation when the response arrives. Measured, most requests return in 1-3 seconds, about 10% take longer than 30 seconds, and the longest is about 230 seconds. Set your client timeout to 300 seconds or more; no response does not mean nothing was generated, and do not retry immediately after a timeout (that duplicates the order and charges again). If the connection dropped, confirm later with
GET /api/music/songs. See "Wait times and timeout settings" in the New API overview.
Authentication
| Parameter | Type | Required | Notes |
|---|---|---|---|
| Authorization | string | yes | Bearer YOUR_API_KEY |
| Content-Type | string | yes | application/json |
Request parameters
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
| model | string | yes | - | Customer-facing model name: suno-v6, suno-v6-wild or suno-v6-mini |
| source_clip_id | string | yes | - | The real song_id of the source song; it must be completed and accessible to the current API key |
| crop_start_s | number | yes | - | Start second of the range to delete; must be 0 or greater |
| crop_end_s | number | yes | - | End second of the range to delete; must be greater than crop_start_s |
| song_title | string | no | - | Title of the result |
Request example
curl -X POST https://www.suno-api.io/api/music/remove-section \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 30,
"crop_end_s": 45,
"song_title": "Trimmed version"
}'
Response
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Trimmed version",
"status": "processing"
}
]
}
}
One call returns 1 result (edit actions do not produce 2 songs). Save clips[].song_id and poll the song query API until it reaches completed.
Notes
- The deleted range must satisfy
0 <= crop_start_s < crop_end_sand lie within the source song's duration. - To keep a range instead, use the crop API.
Get an API key
Create an API key in the console after signing up. ¥0.6 per run returns 2 tracks, downloads are unlimited, and no phone number is required.
Get API key Back to overview