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
custom
enum<boolean>
default:true
required

Custom mode, fixed to true. Audio is generated from the lyrics.

Available options:
true
prompt
string
required

Text to read aloud. Required in custom mode, up to 5000 characters.

background_music
boolean
default:true

Whether to include background music. Defaults to true.

tags
string

Intonation. Describes the tone, pacing, emotion, and scene to convey. Used in custom mode, up to 1000 characters.

vocal_gender
enum<string>

Vocal gender.

  • Male: Male voice

  • Female: Female voice

Available options:
Male,
Female
variety
enum<string>
default:normal

Style variety. Controls how much the generated result varies from the specified style.

  • off: Exact style
  • normal: Balanced variety
  • high: Distinct styles
  • extra: Bold exploration
  • max: Unreasonably varied
Available options:
off,
normal,
high,
extra,
max
audio_format
enum<string>

Audio format of audioUrl after the job succeeds.

Available options:
mp3,
m4a,
wav
Example:

"mp3"

hookUrl
string

Callback notification URL

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on October 3, 2026