Segment Replacement - TTAPI Docs

curl --request POST \ --url https://api.ttapi.io/flowmusic/v1/replace \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "clip_id": "<string>", "start_s": 123, "end_s": 123, "instruction": "<string>", "title": "<string>", "model": "Lyria 3 Pro", "seed": 123, "hook_url": "<string>" } '

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:

{ "job_id": "job_id" }