Skip to main content
POST
cURL

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
music_id
string
required

Parent task's musicId

sound_prompt
string
required

Audio prompt, sound_prompt and lyrics_text cannot both be empty

lyrics_text
string
required

Lyrics text, sound_prompt and lyrics_text cannot both be empty

instrumental
boolean
default:false

Whether to generate pure music

starts
number

Indicates starting replacement from x seconds of the original audio

Example:
ends
number

End time of the replacement segment (seconds)

mv
enum<string>
default:FUZZ-2.0

Model to use, supported options listed above

Available options:
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

Title

cover_art_url
string

Cover URL

seed
string

Random seed

lyrics_strength
number
default:0.5

Lyrics strength, optional 0-1

sound_strength
number
default:0.5

Audio prompt strength, optional 0.2-1

weirdness
number
default:0.5

Style weirdness, optional 0-1

is_storage
boolean
default:false

Whether to save

hook_url
string

Callback notification URL. The data returned is consistent with the task result query response

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on April 26, 2026