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": "job_id"
  }
}
替换歌曲中的指定片段。
提示:替换的歌词 要跟原来的歌词有重复的地方,最好相应的时间能对应上infill_lyrics:表示你要填充或替换进去的“最新歌词片段”。 prompt:表示上下文,需要把“新歌词”前后的原歌词拼接起来。例子:原歌词是 [Verse 1]AA [Chorus]BB [Verse 2] CC [Chorus]DD [Outro]EE,如果你想把 CC 替换为 OOinfill_lyrics 就传 OO(要替换的新歌词)。 prompt 就传 BB [Verse 2]OO[Chorus]DD (在新歌词 OO 前后,保留一部分原歌词,拼成上下文)。这样就能根据 prompt 的上下文和 infill_lyrics 的新歌词片段,生成最佳的结果。
功能特点
  • 精准定位时间区间进行修改
  • 保持前后段落自然过渡
  • 支持重写副歌或优化高潮
  • 适合局部优化与版本调整

Authorizations

TT-API-KEY
string
header
required

授权字段,控制台获取授权信息

Body

application/json
music_id
string
required

音频ID

infill_start_s
number
required

开始替换时间,单位:秒

infill_end_s
number
required

结束替换时间,单位:秒

mv
string
default:chirp-v5
required

使用模型 支持模型如下所示:

  • chirp-v5
  • chirp-v4-5-all
  • chirp-v4-5+
  • chirp-v4-5
  • chirp-v4
  • chirp-v3-5
  • chirp-v3-0
prompt
string

上下文歌词

infill_lyrics
string

新歌词

title
string

音乐标题

自定义模式下(custom=true)使用,最多80字符。

tags
string

音乐风格

自定义模式下(custom=true)使用。

Example:

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

negative_tags
string

不想要生成的音乐风格

自定义模式下(custom=true)使用。

isStorage
boolean
default:false

是否转存

  • true:音频将进行转存,返回TTAPI CDN地址
  • false:返回官方源地址
hookUrl
string

回调通知地址

Response

请求成功

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
{ "job_id": "job_id" }
Last modified on March 12, 2026