Skip to main content
POST
cURL

Authorizations

TT-API-KEY
string
header
required

Please visit TTAPI Dashboard to obtain your API key.

Body

application/json
clip_id
string
required

Source music clip_id

start_s
number
required

Replacement start time in seconds

end_s
number
required

Replacement end time in seconds; must be greater than start_s and cannot exceed source clip duration.

instruction
string
required

Edit instruction for the replaced segment.

title
string

Title after replacement.

model
string
default:Lyria 3 Pro

Music model name; defaults to Lyria 3 Pro when empty

seed
integer

Random seed; used to reproduce or control generation results.

hook_url
string

Business callback URL after task completion; no callback push when empty

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

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