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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

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.

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
music_id
string
required

Audio ID

​
infill_start_s
number
required

Replacement start time, in seconds.

​
infill_end_s
number
required

Replacement end time, in seconds.

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

Model to use.

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

Context lyrics.

​
infill_lyrics
string

New lyrics.

​
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 21, 2026