Text-to-Speech

Text To Speech

Generate speech from text using the specified voice model. Supports emotion, volume, pitch, and tempo customization.

First, list all available voice models using the GET /v2/voices endpoint, then use the voice_id from the response to generate speech with this endpoint. Each voice model has its own unique characteristics. See Listing all voices for available voices.

POST/v1/text-to-speech

curl --request POST \
  --url https://api.typecast.ai/v1/text-to-speech \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --output output.wav \
  --data @- <<EOF
{
  "voice_id": "tc_60e5426de8b95f1d3000d7b5",
  "text": "Everything is so incredibly perfect that I feel like I'm dreaming.",
  "model": "ssfm-v30",
  "language": "eng",
  "prompt": {
    "emotion_type": "smart",
    "previous_text": "I feel like I'm walking on air and I just want to scream with joy!",
    "next_text": "I am literally bursting with happiness and I never want this feeling to end!"
  },
  "output": {
    "volume": 100,
    "audio_pitch": 0,
    "audio_tempo": 1,
    "audio_format": "wav"
  },
  "seed": 42
}
EOF

"[Binary audio data - WAV file content]"

Authorizations

X-API-KEYstringheaderrequired

API key for authentication. You can obtain an API key from the Typecast API Console.

Body

application/json

Text-to-speech request parameters

voice_idstringrequired

Voice identifier. Two prefixes are supported:

tc_ - Built-in Typecast voices (e.g., tc_60e5426de8b95f1d3000d7b5). See Listing all voices for available IDs.
uc_ - Custom voices created via Instant cloning (e.g., uc_64a1b2c3d4e5f6a7b8c9d0e1). Only the owner of a cloned voice can use it.

Case-sensitive: must use lowercase prefix.

textstringrequired

Text to convert to speech. Minimum 1 character, maximum 2000 characters. Credits consumed based on text length. Supports multiple languages including English, Korean, Japanese, and Chinese. Special characters and punctuation are handled automatically.

modelssfm-v30 | ssfm-v21required

Voice model to use for speech synthesis.

ssfm-v30: Latest model with improved prosody and additional emotion presets (recommended)
ssfm-v21: Stable production model with reliable quality

ssfm-v30ssfm-v21

languagestring

Language code following ISO 639-3 standard. Case-insensitive (both "ENG" and "eng" are accepted). If not provided, will be auto-detected based on text content.

ssfm-v30 Supported Languages (37)

Code	Language
ARA	Arabic
IND	Indonesian
POR	Portuguese
BEN	Bengali
ITA	Italian
RON	Romanian
BUL	Bulgarian
JPN	Japanese
RUS	Russian
CES	Czech
KOR	Korean
SLK	Slovak
DAN	Danish
MSA	Malay
SPA	Spanish
DEU	German
NAN	Min Nan
SWE	Swedish
ELL	Greek
NLD	Dutch
TAM	Tamil
ENG	English
NOR	Norwegian
TGL	Tagalog
FIN	Finnish
PAN	Punjabi
THA	Thai
FRA	French
POL	Polish
TUR	Turkish
HIN	Hindi
UKR	Ukrainian
VIE	Vietnamese
HRV	Croatian
YUE	Cantonese
ZHO	Chinese
HUN	Hungarian

ssfm-v21 Supported Languages (27)

Code	Language
ARA	Arabic
IND	Indonesian
RON	Romanian
BUL	Bulgarian
ITA	Italian
RUS	Russian
CES	Czech
JPN	Japanese
SLK	Slovak
DAN	Danish
KOR	Korean
SPA	Spanish
DEU	German
MSA	Malay
SWE	Swedish
ELL	Greek
NLD	Dutch
TAM	Tamil
ENG	English
POL	Polish
TGL	Tagalog
FIN	Finnish
POR	Portuguese
UKR	Ukrainian
FRA	French
HRV	Croatian
ZHO	Chinese

promptPrompt

Emotion and style settings for the generated speech, including emotion type (happy/sad/angry/normal) and intensity (0.0 to 2.0) to control the emotional expression

SmartPrompt (ssfm-v30)

emotion_typestring

Discriminator field to identify the prompt type. Must be set to "smart" for context-aware emotion inference.

previous_textstring

Text that comes BEFORE the text field in TTSRequest. Provides backward context for emotion inference.

The model analyzes the flow: previous_text → text (synthesized) → next_text

Maximum 2000 characters
Helps the model understand emotional build-up and context
Leave empty if no preceding context is available

next_textstring

Text that comes AFTER the text field in TTSRequest. Provides forward context for emotion inference.

The model analyzes the flow: previous_text → text (synthesized) → next_text

Maximum 2000 characters
Helps the model anticipate emotional transitions
Leave empty if no following context is available

PresetPrompt (ssfm-v30)

emotion_typestring

Discriminator field to identify the prompt type. Must be set to "preset" for preset-based emotion control.

Emotion preset to apply to the generated speech.

Supported emotions: normal, happy, sad, angry, whisper, toneup, tonedown

Check available emotions for each voice through the /v2/voices API.

normalsadhappyangrywhispertoneuptonedown

emotion_intensitynumber

Controls the strength of emotional expression in the generated speech.

0.0: Completely neutral, no emotional coloring
0.5: Subtle emotional hints
1.0: Standard emotional expression (default)
1.5: Strong emotional emphasis
2.0: Maximum intensity, highly expressive

Prompt (ssfm-v21)

emotion_presetobject

Emotion preset to apply.

Supported emotions for ssfm-v21: normal, happy, sad, angry

Check available emotions for each voice through the /v2/voices API.

emotion_intensityobject

Controls the strength of emotional expression (0.0 to 2.0).

0.0: Completely neutral
1.0: Standard expression (default)
2.0: Maximum intensity

outputobject

Audio output settings including volume (0-200), pitch (-12 to +12 semitones), tempo (0.5x to 2.0x), and format (wav/mp3) for controlling the final audio characteristics

Show nested model

target_lufsnumber

Sets the target absolute loudness (LUFS) for the output audio. This normalizes all generated voices to a consistent volume level, regardless of the original source's loudness. Values closer to 0 are louder, while values closer to -70 are quieter.

Required range: -70 <= x <= 0
Recommended values: -14 (common streaming standard), -23 (broadcast standard)
Note: This parameter cannot be used simultaneously with the volume parameter. Use target_lufs for consistent absolute loudness across different clips, or use volume for traditional relative scaling.

volumeinteger

Adjusts the relative volume of the output audio: 0 (completely silent), 50 (half volume), 100 (standard volume, default), 150 (50% louder than standard), 200 (maximum volume, twice as loud as standard).

Since this only scales the existing volume, using volume can amplify the loudness differences between voices if they have different baseline levels. For consistent output across all clips, use target_lufs instead.

Note: This parameter cannot be used simultaneously with the target_lufs parameter.

Required range: 0 <= x <= 200

audio_pitchinteger

Adjusts the pitch in semitones to affect perceived gender and age: -12 (one octave lower, deeper voice), -6 (half octave lower), 0 (original pitch, default), +6 (half octave higher), +12 (one octave higher, higher voice)

audio_temponumber

Controls speech speed: 0.5 (half speed, very slow and clear), 0.75 (slightly slower than normal), 1.0 (normal speaking speed, default), 1.5 (50% faster than normal), 2.0 (double speed, very fast speech)

audio_formatwav | mp3

Output audio format.

WAV format:

Uncompressed PCM audio
16-bit depth, mono channel, 44100 Hz sample rate
Higher quality, larger file size
Recommended for professional audio production

MP3 format:

Compressed MPEG Layer III audio
320 kbps bitrate, 44100 Hz sample rate
Smaller file size
Recommended for web streaming and distribution

wavmp3

seedinteger

Unsigned integer seed for reproducible speech generation. The same seed with the same input parameters will produce identical audio output.

Must be a non-negative integer (≥ 0). Negative values are not accepted.
If omitted, the server generates a random seed each time, producing slight variations.

Response

200Success - Returns audio fileaudio/wav · audio/mpeg

curl --request POST \
  --url https://api.typecast.ai/v1/text-to-speech \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --output output.wav \
  --data @- <<EOF
{
  "voice_id": "tc_60e5426de8b95f1d3000d7b5",
  "text": "Everything is so incredibly perfect that I feel like I'm dreaming.",
  "model": "ssfm-v30",
  "language": "eng",
  "prompt": {
    "emotion_type": "smart",
    "previous_text": "I feel like I'm walking on air and I just want to scream with joy!",
    "next_text": "I am literally bursting with happiness and I never want this feeling to end!"
  },
  "output": {
    "volume": 100,
    "audio_pitch": 0,
    "audio_tempo": 1,
    "audio_format": "wav"
  },
  "seed": 42
}
EOF

"[Binary audio data - WAV file content]"

curl --request POST \ --url https://api.typecast.ai/v1/text-to-speech \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: <api-key>' \ --output output.wav \ --data @- <<EOF { "voice_id": "tc_60e5426de8b95f1d3000d7b5", "text": "Everything is so incredibly perfect that I feel like I'm dreaming.", "model": "ssfm-v30", "language": "eng", "prompt": { "emotion_type": "smart", "previous_text": "I feel like I'm walking on air and I just want to scream with joy!", "next_text": "I am literally bursting with happiness and I never want this feeling to end!" }, "output": { "volume": 100, "audio_pitch": 0, "audio_tempo": 1, "audio_format": "wav" }, "seed": 42 } EOF

Code

Language

ARA

Arabic

IND

Indonesian

POR

Portuguese

BEN

Bengali

ITA

Italian

RON

Romanian

BUL

Bulgarian

JPN

Japanese

RUS

Russian

CES

Czech

KOR

Korean

SLK

Slovak

DAN

Danish

MSA

Malay

SPA

Spanish

DEU

German

NAN

Min Nan

SWE

Swedish

ELL

Greek

NLD

Dutch

TAM

Tamil

ENG

English

NOR

Norwegian

TGL

Tagalog

FIN

Finnish

PAN

Punjabi

THA

Thai

FRA

French

POL

Polish

TUR

Turkish

HIN

Hindi

UKR

Ukrainian

VIE

Vietnamese

HRV

Croatian

YUE

Cantonese

ZHO

Chinese

HUN

Hungarian