Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No audio yet. Submit the form to generate audio.
Transparent pricing with no hidden fees. Pay as you go.
| Rule & Modality | Channel | Credits | Price (USD) | Official / Reference Price | Daily Savings |
|---|---|---|---|---|---|
Suno replace-section musicSuno | Starter | 1per run | $0.005 | - | - |
Complete guide to using Suno
Use the Suno Replace Section API on ApiPass to regenerate a specific part of an existing song while preserving the rest of the track workflow. Submit a source task and audio track, define the replacement interval, provide a new prompt, style tags, title, and complete updated lyrics, then query the asynchronous task result or receive it by callback.
Suno Replace Section is an AI music editing workflow for replacing a defined time range inside an existing song. Instead of regenerating an entire track, developers can target a bridge, chorus, verse, or transition and guide the replacement with new content direction, music style tags, and full lyrics after the edit. ApiPass supports asynchronous task creation through /api/v1/jobs/createTask and status retrieval through /api/v1/jobs/recordInfo. The replacement interval must be at least 10 seconds, infillEndS must be greater than infillStartS, and fullLyrics must contain the complete post-edit lyrics, including unchanged sections and the new replacement section.
Regenerate a specific section of an existing Suno audio track by providing taskId, audioId, infillStartS, infillEndS, prompt, tags, title, and fullLyrics. This lets applications revise individual moments without rebuilding the whole music creation workflow.
Use fullLyrics to provide the entire lyric structure after the replacement. The API expects unchanged sections and the regenerated section in the correct position, which helps preserve song continuity while changing the selected interval.
Create a replace-section task, receive an ApiPass taskId, then poll /api/v1/jobs/recordInfo or provide callBackUrl to receive completion notifications. Successful results include resultJson with generated audio track data, including audio_url and image_url.
Set infillStartS and infillEndS in seconds to define the exact replacement interval. ApiPass accepts integers, decimals, and numeric strings, normalizes compatible numeric values, and validates that the interval is at least 10 seconds.
Guide the regenerated section with a prompt, music style tags, a song title, and optional negativeTags. This makes it useful for changing the emotional arc of a bridge, softening a chorus, or steering a replacement away from unwanted genres or instrumentation.
Track task states such as waiting, queuing, generating, success, and fail. After success, parse resultJson and read generated audio results from the data array, including each track id, audio_url, and cover image_url.
Build interfaces that let users revise only one part of a generated song, such as replacing a weak bridge, rewriting a chorus, or updating a verse while keeping the rest of the production intact.
Create lyric-focused applications where users edit the full song text, mark a target time range, and regenerate the selected section with updated lyrics and style direction.
Integrate replace-section generation into automated music production systems that iterate on sections, poll task status, parse resultJson, and store finished audio assets for downstream publishing or review.
Choose the replace-section workflow when the source song already exists and only a targeted interval needs to change.
Full music generation creates a new song from prompts, lyrics, and style choices. Replace Section is designed for post-generation revision: it uses an existing taskId and audioId, replaces a defined time interval, and requires fullLyrics so the output keeps the intended full-song structure.
Extend workflows lengthen an audio track while preserving its style and melody. Replace Section edits material inside the existing song, making it better for revising a problematic chorus, bridge, or transition without changing the song length strategy.
The supplied playground content lists Replace Section at 5 credits per task. Actual billing can depend on account settings and channel routing, so review the current ApiPass dashboard before production usage.
Use the optional channel parameter to choose auto, starter, regular, or official routing. The default auto channel lets ApiPass allocate tasks across available providers based on real-time pricing and stability metrics.
Targeted section replacement can reduce iteration time for music products because teams can revise specific sections instead of repeatedly regenerating and reviewing entire songs.
Generate or locate a completed Suno source task, then collect the source taskId and the target audioId. Existing Suno audio mode requires both values and should not include uploadUrl or input.model in the same request.
Send a POST request to https://api.apipass.dev/api/v1/jobs/createTask with model set to suno/replace-section. Provide prompt, tags, title, infillStartS, infillEndS, and fullLyrics. Keep the replacement interval at least 10 seconds and make sure fullLyrics contains the complete lyrics after replacement.
Use the returned ApiPass data.taskId with /api/v1/jobs/recordInfo, or provide callBackUrl during task creation for completion notifications. When the task succeeds, parse resultJson and read generated audio files from resultJson.data[].audio_url.
The API page shows the parameter schema, but Suno also has several business-specific mode combinations and callback rules that are easy to miss.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Submit a Suno Replace Section task to regenerate a specified section of an existing song using a new prompt, tags, title, and complete lyrics.
The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/replace-section",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "taskId": "string (conditional)",
7 "audioId": "string (conditional)",
8 "prompt": "string",
9 "tags": "string",
10 "title": "string",
11 "negativeTags": "string (optional)",
12 "infillStartS": 10.5,
13 "infillEndS": 20.75,
14 "fullLyrics": "string"
15 }
16}modelRequiredstringThe public model name. For this endpoint, it must be fixed as suno/replace-section.
"suno/replace-section"
callBackUrlOptionalstringCallback URL for task completion notifications. If omitted, no callback will be sent.
"https://your-domain.com/api/callback"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
The input object contains the parameters for the source audio, replacement section, style, title, and complete lyrics.
input.taskIdOptionalstringApiPass task ID (task_xxx) of the completed suno/generate or suno/extend source task. Conditionally required with input.audioId when replacing a section from an existing Suno task.
Use this field together with input.audioId for existing Suno audio mode. ApiPass maps this ApiPass task ID to the provider task ID automatically; do not use the new task ID returned by this request. Do not send input.uploadUrl or input.model in this mode. Compatible aliases: task_id, task.
"task_yyyyyyyyyyyyyyyy"
input.audioIdOptionalstringAudio track ID from the completed source Suno task. Conditionally required with input.taskId when replacing a section from an existing Suno task.
Use this field together with input.taskId for existing Suno audio mode. Do not send input.uploadUrl or input.model in this mode. Compatible alias: audio_id.
"e231xxxx-xxxx-xxxx-xxxx-xxxx8cadc7dc"
input.promptRequiredstringPrompt describing the lyrics or content to generate for the replacement section.
Provide the lyric or content direction for the replacement section. This field cannot be empty.
"A calm and relaxing piano bridge"
input.tagsRequiredstringMusic style tags for the replacement, such as Jazz, electronic, piano, acoustic pop, or cinematic.
"Jazz, piano"
input.titleRequiredstringTitle of the output song.
"Peaceful Piano"
input.negativeTagsOptionalstringMusic styles or elements to avoid in the generated replacement section.
Compatible alias: negative_tags.
"heavy metal, distorted guitar"
input.infillStartSRequirednumberReplacement interval start time in seconds. Must be greater than or equal to 0.
Supports integers, decimals, and numeric strings such as 10, 20.75, and "10.5". ApiPass normalizes numeric strings to numbers before sending. Compatible aliases: infill_start_s, start, start_time.
10.5
input.infillEndSRequirednumberReplacement interval end time in seconds. Must be strictly greater than input.infillStartS.
Supports integers, decimals, and numeric strings. infillEndS must be greater than infillStartS, and the interval must be at least 10 seconds. Upstream documentation recommends using at most two decimal places. Compatible aliases: infill_end_s, end, end_time.
20.75
input.fullLyricsRequiredstringComplete lyrics for the song after replacement. This must include both unchanged lyrics and the regenerated section, not only the replacement segment.
Send the complete lyrics after replacement, including unchanged sections and the new section in the correct position. Compatible aliases: full_lyrics, lyrics.
"[Verse 1]\nOriginal lyrics\n[Bridge]\nNew bridge lyrics\n[Chorus]\nOriginal chorus"
1curl --request POST \
2 --url "https://api.apipass.dev/api/v1/jobs/createTask" \
3 --header "Authorization: Bearer ${APIPASS_API_KEY}" \
4 --header "Content-Type: application/json" \
5 --data '{
6 "model": "suno/replace-section",
7 "callBackUrl": "https://your-domain.com/api/callback",
8 "channel": "auto",
9 "input": {
10 "taskId": "task_yyyyyyyyyyyyyyyy",
11 "audioId": "e231xxxx-xxxx-xxxx-xxxx-xxxx8cadc7dc",
12 "prompt": "A calm and relaxing piano bridge",
13 "tags": "Jazz, piano",
14 "title": "Peaceful Piano",
15 "infillStartS": 10.5,
16 "infillEndS": 20.75,
17 "fullLyrics": "[Verse 1]\nOriginal lyrics\n[Bridge]\nNew bridge lyrics\n[Chorus]\nOriginal chorus"
18 }
19 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxxxxxxxxxxxxxxx"
6 }
7}codeStatus code, 200 for success, others for failure.
messageResponse message. When the request fails, this contains the error description.
data.taskIdApiPass task ID used to query task status and results with the Query Task API.
MiniMax
MiniMax
MiniMax Music 1.5 AI music generation model, supports lyrics and style prompt to generate music
Starting from
0 credits
Starting from
0 credits