Skip to main content
POST
cURL
This endpoint no longer accepts the mv parameter. You do not need to specify a model.

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
music_id
string
required

Audio ID

variation_category
enum<string>

Controls how strongly the song is transformed.

Available options:
subtle,
normal,
high
audio_format
enum<string>

Audio format of audioUrl after the job succeeds.

Available options:
mp3,
m4a,
wav
Example:

"mp3"

hookUrl
string

Callback notification URL

isStorage
boolean
default:true
deprecated

Whether to store the generated audio.

  • true: The audio will be stored and a TTAPI CDN URL will be returned
  • false: The original source URL will be returned

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on September 10, 2026