Skip to main content
POST
/
suno
/
v1
/
replace-section
cURL
curl --request POST \
  --url https://api.ttapi.io/suno/v1/replace-section \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "music_id": "<string>",
  "infill_start_s": 123,
  "infill_end_s": 123,
  "mv": "chirp-v5",
  "prompt": "<string>",
  "infill_lyrics": "<string>",
  "title": "<string>",
  "tags": "rock, blues, hip-hop, r&b",
  "negative_tags": "<string>",
  "isStorage": false,
  "hookUrl": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
Tip: The replacement lyrics should have some overlap with the original lyrics, and ideally the timing should align.infill_lyrics: The new lyric segment you want to fill in or replace.prompt: The context—concatenate the original lyrics before and after the new lyrics.Example: Original lyrics are [Verse 1]AA [Chorus]BB [Verse 2]CC [Chorus]DD [Outro]EE. If you want to replace CC with OO:
  • Set infill_lyrics to OO (the new lyrics to insert).
  • Set prompt to BB [Verse 2]OO[Chorus]DD (include part of the original lyrics before and after OO to form the context).
This allows the model to generate the best result based on the surrounding context in prompt and the new lyrics in infill_lyrics.
Features:
  • Precisely modify specific time segments
  • Maintain natural transitions between sections
  • Support rewriting choruses or enhancing climaxes
  • Ideal for partial improvements and version adjustments

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
music_id
string
required

音频ID

​
infill_start_s
number
required

开始替换时间，单位：秒

​
infill_end_s
number
required

结束替换时间，单位：秒

​
mv
enum<string>
default:chirp-v5
required

Model to use.

Available options:
chirp-v5,
chirp-v4-5+,
chirp-v4-5,
chirp-v4-5-all,
chirp-v4,
chirp-v3-5,
chirp-v3-0
​
prompt
string

上下文歌词

​
infill_lyrics
string

新歌词

​
title
string

Music title.

Used in custom mode (custom=true). Maximum length: 80 characters.

​
tags
string

Music style or genre.

Used in custom mode (custom=true).

Example:

"rock, blues, hip-hop, r&b"

​
negative_tags
string

Music styles or genres that should be excluded from generation.

Used in custom mode (custom=true).

​
isStorage
boolean
default:false

Whether to store the generated audio.

  • true: The audio will be stored and a TTAPI CDN URL will be returned
  • false: The original source URL will be returned
​
hookUrl
string

Callback notification URL

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 13, 2026