跳转到主要内容
POST
/
producer
/
v1
/
replace
cURL
curl --request POST \
  --url https://api.ttapi.io/producer/v1/replace \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "music_id": "<string>",
  "sound_prompt": "<string>",
  "lyrics_text": "<string>",
  "instrumental": "false",
  "starts": [
    "30.01"
  ],
  "ends": 123,
  "mv": [
    "FUZZ-2.0 Pro",
    "FUZZ-2.0",
    "FUZZ-2.0 Raw",
    "FUZZ-1.1 Pro",
    "FUZZ-1.0 Pro",
    "FUZZ-1.0",
    "FUZZ-1.1",
    "FUZZ-0.8",
    "Lyria 3 preview"
  ],
  "title": "<string>",
  "cover_art_url": "<string>",
  "seed": "<string>",
  "lyrics_strength": "0.5",
  "sound_strength": "0.5",
  "weirdness": "0.5",
  "is_storage": "false",
  "hook_url": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
music_id
string
必填

父任务的musicId

sound_prompt
string
必填

音频提示词,sound_prompt与lyrics_text不可同时为空

lyrics_text
string
必填

歌词文本,sound_prompt与lyrics_text不可同时为空

instrumental
boolean
默认值:false

是否生成纯音乐,true 为生成纯音乐,true的情况下会忽略自定义歌词

starts
number

表示从原始音频的 x 秒处开始进行替换,单位(秒)

示例:
["30.01"]
ends
number

替换片段的结束时间(秒),为空表示替换将持续到音频的末尾

mv
string
默认值:FUZZ-2.0

使用模型,支持范围

示例:
[
"FUZZ-2.0 Pro",
"FUZZ-2.0",
"FUZZ-2.0 Raw",
"FUZZ-1.1 Pro",
"FUZZ-1.0 Pro",
"FUZZ-1.0",
"FUZZ-1.1",
"FUZZ-0.8",
"Lyria 3 preview"
]
title
string

标题

cover_art_url
string

封面url

seed
string

随机种子

lyrics_strength
number
默认值:0.5

歌词强度,表示歌词在音频生成中的影响程度,可选0-1之间

sound_strength
number
默认值:0.5

音频提示词强度,可选0.2-1之间

weirdness
number
默认值:0.5

风格奇特度,可选 0-1之间

is_storage
boolean
默认值:false

是否转存 true-转存 false-不转存

hook_url
string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
{ "job_id": "job_id" }
Last modified on March 12, 2026