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
title
string

Music generation title

model
string
default:Lyria 3 Pro

Music model name, defaults to Lyria 3 Pro when empty

sound_prompt
string

Music style or sound description prompt; cannot be empty together with lyrics

lyrics
string

Lyrics text; cannot be empty together with sound_prompt

seed
string

Random seed

bpm
string

BPM, must be greater than or equal to 1

length
integer

Generated music duration in seconds; can be empty, range 1 to 240

Required range: 1 <= x <= 240
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